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Traitement de documents XML 

XSLT est un langage ne de la necessite de traiter des documents XML. 

Traiter des documents XML est de fait une necessite, etant donne son utilisation massive 
dans un grand nombre de secteurs de l'informatique, mais traiter un document XML par 
XSLT n'en n'est pas une : ce n'est qu'une possibility parmi d'autres. Actuellement, il y a 
trois voies differentes pour le traitement d'un document XML : 

• On peut utiliser une feuille de style CSS, si le but est uniquement un habillage HTML 
du document XML : les possibilites se reduisent en gros a des choix de rendu d' aspect 
du document, comme la taille d'une fonte, l'epaisseur d'un cadre, etc. II est impossible 
de modifier la structure du document, mais dans des cas tres simples, et a condition 
que le traitement puisse etre confie a un navigateur, cela peut suffire. 

• On peut developper un programme de traitement, par exemple en Java, ou en d' autres 
langages permettant d'acceder facilement a la representation arborescente d'un docu- 
ment XML (avec Java, par exemple, on dispose d' API comme DOM, JDOM ou SAX 
pour ce faire). Dans ce cas, il n'y a aucune limitation, on fait ce qu'on veut, et ou on 
veut (aussi bien sur un serveur que sur un poste client). 

• Enfin, on peut utiliser XSL (extensible Stylesheet Language), qui regroupe des lan- 
gages specifiques pour la description de transformations et de rendu de document 
XML, dont XSLT fait partie. II n'y a en principe pas de limitation theorique a la nature 
des traitements realisables par XSL, du moment qu'on s'en tient a vouloir traiter des 
documents XML ; XSL est utilisable aussi bien sur le poste client que sur un serveur. 

Comme XSL est specialement adapte au traitement de documents XML, on peut penser 
qu'il est plus simple de realiser le traitement desire en XSL, plutot que d' utiliser un langage 
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generaliste comme Java ou C++. C'est vrai, mais cette affirmation doit etre largement 
nuancee dans la pratique. En effet, un des problemes de XSL en general et de XSLT en 
particulier, est que ce sont des langages assez destabilisants, dans la mesure ou ils 
demandent aux programmeurs des competences dans des domaines qui sont generale- 
ment assez peu frequentes. Un expert XSLT mettra tres certainement beaucoup moins de 
temps a realiser le traitement demande que l'expert Java utilisant les API SAX (Simple 
API for XML) ou DOM (Document Object Model) pour faire le meme travail ; le seul 
probleme, a vrai dire, est d'etre expert XSLT. 

A titre de comparaison, lorsque le langage Java a ete rendu public et disponible, un expert 
C++ ou Smalltalk (ou langage a objets, d'une facon plus generate) a qui Ton presentait ce 
langage, en faisait le tour en une semaine, le temps de s'habituer aux caracteristiques spe- 
cifiques ; mais son mode de pensee restait fondamentalement intact. 

A l'inverse, prenez un expert SQL, ou Java, ou C, ou Visual Basic, et presentez-lui 
XSLT : il n'aura pratiquement rien a quoi se raccrocher ; tout pour lui sera nouveau ou 
presque, sauf s'il a une bonne culture dans le domaine des langages fonctionnels ou 
declaratifs (Prolog, Lisp, Caml, etc.). 

Pourtant, il ne faut pas croire que XSLT soit un langage specialement difficile ou com- 
plexe ; il est meme beaucoup moins complexe que C++. Mais il est deroutant, parce qu'il 
nous fait penetrer dans un monde auquel nous ne sommes en general pas habitues. 

En resume, si vous avez a faire un traitement non trivial sur un document XML, et que 
vous etes novice en XSLT, prevoyez une phase importante d'investissement personnel 
initial dans le calcul de votre delai, ou realisez votre traitement en programmation tradi- 
tionnelle, avec des API comme SAX ou DOM. Mais ce n'est pas une solution rentable a 
moyen terme, car il est certain qu'une fois la competence acquise, on est beaucoup plus 
efficace en XSLT qu'on peut l'etre en Java ou C++ pour realiser une transformation 
donnee. 

Le langage XSL 
Statut actuel 

Le W3C n'est pas un organisme de normalisation officiel ; il ne peut done pretendre edi- 
ter des normes ou des standards. C'est pourquoi un document final du W3C est appele 
Recommendation, terme qui peut sembler un peu bizarre au premier abord. Mais une 
Recommendation du W3C n'a rien a voir avec un recueil de conseils, et c'est un docu- 
ment qui equivaut de fait a un standard, redige dans le style classique des specifications. 
Dans toute la suite, nous parlerons neanmoins de standards XSL ou XSLT, meme si ce ne 
sont pas des standards au sens officiel du terme. 

Le langage XSL (extensible Stylesheet Language) est un langage dont la specification 
est divisee en deux parties : 

• XSLT (XSL Transformation) est un langage de type XML qui sert a decrire les trans- 
formations d'un arbre XML en un autre arbre XML. Le standard XSLT 1.0 est une 
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W3C Recommendation du 16 novembre 1999 (voir www.w3.org/TR/xslt). A noter que les 
attributs de certains elements XML de ce langage contiennent des chaines de carac- 
teres dont la syntaxe et la semantique obeissent a un autre langage, nomme XPath (XML 
Path Language), qui n'a rien a voir avec XML, et dont le but est de decrire des ensem- 
bles de noeuds de l'arbre XML du document source a traiter. Le langage XPath 1.0 a 
fait l'objet d'une W3C Recommendation du 16 novembre 1999 (voir http://www.w3c.org/ 
TR/xpath). 

• XSLFO (XSL Formating Objects) est un langage de type XML utilise pour la descrip- 
tion de pages imprimables en haute qualite typographique. Le standard XSLFO 1 .0 est 
une W3C Recommendation du 15 octobre 2001 (voir http://www.w3c.org/TR/XSL). 

Ces deux parties s'integrent dans une chaine de production resumee a la figure 1-1. 
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Figure 1-1 

Les deux composantes de XSL. 



XSLT peut etre utilise seul, et d'ailleurs, pendant les deux ans qui ont separes la publica- 
tion des standards respectifs de XSLT et XSLFO, on ne pouvait guere faire autrement 
que d'utiliser XSLT seul. 

Inversement, il ne semble pas tres pertinent et encore moins facile d'utiliser XSLFO 
seul : la description de pages imprimables reclame des competences qui relevent plus de 
celles d'un typographe. A defaut de les posseder, il semble plus prudent de laisser la 
generation de documents XSLFO a un processeur XSLT equipe de regies de traduction 
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adequates et toutes faites, ou tout au moins d'une bi bl iotheque de regies de plus haut 
niveau que eel lesqu'on pourraitecrireen partantdezero sur la comprehension desobjets 
manipules par XSLFO. Une autre possibility pourrait etre d'employer un logiciel de 
transformation, qui generedu FO a parti rde documents RTF ou Latex, parexemple, mais 
on entreici dansun domainequi n'a plus rien avoir avec I'objet de ce livre. 

Comme on peut le voir sur la figure 1-1, il est possible, sous certaines conditions, d'obte- 
nirdu texte, du HTM L ou du XM L en sortiedeXSLT. En effet, bien queXSLT soittou- 
jours presente comme un langage de transformation d'arbres XML (I'arbre XML du 
document source est transforms en un autre arbre XML resultat), un processeur X SLT est 
equipe d'un serialisateur qui permet d'obtenir une representation de I'arbre resultat sous 
la forme d'une suite de caracteres. Le processus de serialisation est parametrable pour 
obtenirfacilementdu texte brut, du HTML ouduXML. Comme on peut obtenirdu texte 
brut non balise au format XML, on peut done envisager de programmer des transfor- 
mations qui aboutissent a des documents RTF ou Latex, voire directement au format 
Postscript ou PDF. Mais comme les processeurs XSLFO commencent a offrir un fonc- 
tionnement stable et utilisable, ce genre de prouesse sera probablement de moins en 
moins envisaged a I 'avenir. 

Une des transformations les plus courantes reste bien stir la transformation XML vers 
XHTML ouHTML, maisil nefaut pas i magi ner que le langage X SLT a ete fait pour 5a, 
memesi I 'allusion aux f eui 1 1 esde style (stylesheet) danslenom memed'XSL encourage 
a cette assimilation beaucoup trop reductrice : la production d'HTM L n'est qu'une pos- 
sibilite parmi d'autres. 

Evolutions 

XSL est un langage qui evolue sous la pression des utilisateurs, des implementeurs de 
processeurs X SLT ou XSL-FO, et des grands editeurs de logiciels. Le role du W3C est 
entre autres de canal iser ces evolutions, afin de prendre en compte les demandes les 
plus i nteressantes, et de les elever au rang de standard (ou W3C Recommendation). Le 
20 decembre 2001, le W3C a publie des Working Drafts annoncant des evolutions 
majeures de X SLT et de X Path : W3C Working Draft XSLT2.0 et W3C Working Draft 
XPath 2.0. Ces documents deboucheront a terme sur un standard X SLT 2.0 et un stan- 
dard X Path 2.0. Pour I ' i nstant beaucoup de choses restent en di scussi on, et d'ai 1 1 eurs I 'un 
des buts de ces publications est precisement de declencher les debats et les reactions, 
dont les retombees peuventeventuellementetre extremement importantes dans les choix 
final ement retenus. 

Avant \eW3C Working Draft XSLT 2.0, il y a eu un W3C Working Draft XSLT 1.1, qui est 
reste et restera a jamais a I'etat de Working Draft, car le groupe de travail charge de la 
redaction de la Final Recommendation s'est rendu compte que les evolutions proposees 
etaient vraiment majeures, et s'accordaient done mal avec un si mple passage de 1.0 a 1.1. 
Lestravaux dela lignee l.xx ontdonc ete abandonnes, et reintegresaceux dela lignee 
2.xx. 
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Divers modes d'utilisation de XSLT 

XSLT estun langage interprete ; acetitreil reclame un interpreter (souventappele pro- 
cesses XSLT) qui peutetre lance dedi verses facons, suivant I'objectif aatteindre. 

Mode Commande 

Le mode Commande est le mode qui consiste a lancer (a la main ou en tant que com- 
mande faisant partie d'un fichier de commandes) le processeur XSLT en lui passant les 
arguments qu'il attend (le fichier contenant la feuillede style XSLT aexecuter, le fichier 
X M L a traiter, et le nom du fichier resultat, plus divers parametres ou options). 

Ce mode convient pour les traitementsnon interactifs, et c'est d'ailleurs eel ui qui offrele 
plus de souplesse en ce sens qu'il ne requiert aucune liaison particuliere entre le fichier 
XML et la feuille de style de traitement : la meme feuille de style peut traiter plusieurs 
fichiersXM L differents, etun memefichierXM L peut etre traite par plusieurs feuilles de 
style XSLTdifferentes. 

C'est aussi un mode qui n'impose aucun format de sortie particulier : on peut generer 
aussi bien du HTML que du XML, du Latex, etc. 

Processeurs courants 

En mode Commande, I es processeurs les pi us courants sontXt, Xal an, et Saxon. 

Xt est le premier processeur XSLT a etre apparu ; il a ete ecrit par un grand maitre de 
SGML et de DSSSL (['equivalent de XSLT pour SGM L), James Clark, qui est aussi 
I'editeur de la normeXSLT 1.0 du W3C. Xt n'est pas tout a fait complet, et ne le sera 
jamais, car il n'y a plus aucun developpement sur ce produit. Cependant, Xt reste 
auj ourd'hui le pi us rapide de tous I es processeurs X SLT. C 'est un produit « open source » 
gratuit (ecrit en J ava), que I 'on peut obtenir sur www.jciark.com/xmi/xt.htmi. 

Saxon est le processeur XSLT ecrit par Michael Kay, egalement auteur du premier 
manuel de reference sur le langage XSLT. C'est un produit libre et gratuit, dont les 
sources SOnt disponibles (en J ava) Sur http://saxon.sourceforge.net/. 

Pour I'avoir utilise, mon avis est qu'il est tres rapide, bien documents et tres stable. De 
plus, il est complet, et meme plus que complet, puisqu'il implementeles nouvellesfonc- 
tionnalitesannonceesdansleW3C Working Draft XSLT 1.1, et meme, a titre experimen- 
tal, cellesannoncees dans leW3C Working DraftXSLT 2.0. 

Une version empaquetee sous forme d'un executable Windows existe aussi (Instant 
Saxon), mais n'est pas aussi rapide a I'execution que la version ordinaire. E Me est a 
conseilleruniquementaceux qui veulent tester Saxon sur une plate-forme Windows sans 
avoir a installer unemachinevirtuellejava. 

Xalan est un processeur « open source » produit par Apache. C'est un produit libre et 
gratuit, dont les sources sont disponibles, quel'on peut I 'obtenir sur http://xmi.apache.org/ 
xalan-j/. 
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Comme Saxon, c'est un produit tres largement utilise par la communaute d'utilisateurs, 
done tres fiable. 1 1 est complet par rapport au standard X SLT 1.0. 
Signalons pour finir que MSXSL, le processeur XSLT de Microsoft (fourni avec 
M SXM L3 ou 4), est fait pour etre lance en mode Commande, bien que les transfor- 
mations XSLT autraversdu navigateur Internet Explorer soient plus popul aires. Surles 
plates-formes Windows, il est plus rapide que Saxon. 

II y a evidemment beaucoup d'autres processeurs XSLT : on pourra, si I'on veut, faire 
son marche sur certains sites qui les recensent, comme par exemple : www.w3c.org/styie/ 
XSL, www.xmlsoftware.com/xslt, et www.xml.com/. 

Mode Navigateur 

Le mode navigateur est un mode qui ne fonctionne qu'avec un navigateur equipe d'un 
processeur XSLT (par exemple Internet Explorer 5 avec MSXML3 (ou 4), IE6 ou 
N etscape 6). A priori, ce mode de fonctionnement est typiquement fait pour que la trans- 
formation XSL aboutisse a du HTML : le serveur HTTP, en reponse a une requete, 
envoie un document XML et la feuille de style qui genere le code HTM L adequat. Le 
gain attendu est double (voire triple) : 

• L es documents X M L qui transitent sur le reseau sont general ement moi ns bavards que 
leur equivalent HTM L : on gagne de la bande passante. 

• II arrive assez souvent que cesoit la meme feuille de style qui puissetraiter plusieurs 
documents XML differents (en provenance du meme serveur) ; dans ce cas les tech- 
niques de memoire cache sur le navigateur economisent a nouveau de la bande pas- 
sante. 

• A plus long terme, si le contenu du Web s'enrichit progressivement de documents 
deplus en plus souvent XML et de moins en moins souvent HTML, les moteurs de 
recherche auront moins de mal a selectionner de I'information plus pertinente, parce 
que X M L est beaucoup plus tourne vers I 'expression de la semantique du contenu que 
nel'estHTML. 

N'oublions pas non plus que la transformation XSLT sur le poste client decrolt de fagon 
notable la charge du serveur en termes de CPU et de memoire consommee : moins de 
bande passante reseau utilisee et moins de ressources consommees sur I e serveur sont les 
gains theoriques que I'on peut attendre de ce mode de fonctionnement. Mais bien sflr, il 
faudra du temps pour que tout cela deviennecourant : pour I'instant I 'evolution vers le 
traitement local de pages X M L ne fait que commencer. 

Processeurs courants 

En mode Navigateur, il n'y a guere que IE5 ou IE6 de M icrosoft qui soient vraiment 
aboutis pour les transformations XSLT (bien que Netscape 6 soitdepuis peu un concur- 
rent dans ce domaine). A noter que IE5 necessite une installation auxiliaire, celle de 
MSXML3 (ou 4), qui offre une bonne implementation deXSLT 1.0. On peutobtenir 
MSXML3ouMSXML4sur http://msdn.microsoft.com/xml. 
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Netscape 6 est une alternative interessante pour XSLT. II peut y avoir encore quelques 
problemes d'application de feuilles CSS au resultat obtenu, mais les evolutions sont 
rapides en ce moment: il faut consulter le site www.moziiia.org/projects/xsit pour avoir 
I 'information la plus a jour. 



Mode Serveur 



Dans le mode serveur, le processeur XSLT est charge en tant que thread (processus 
leger), etil peut etre invoque paruneAPI Java adequate (generalement I 'A PI TrAX) pour 
generer des pages HTML (ou PDF) a la volee. Typiquement, le serveur HTTP recoit 
une requete, etuneservletou unepageASP vachercher une page XM L (qui contientune 
reference a la feuillede style XSLT a charger). CettepageXM L esttransmiseau thread 
XSLT qui va la transformer en HTM L, en utilisantau passage des donnees annexes (par 
exemple le resultat d'une requete SQL). U ne autre possibilite est que le resultat du traite- 
mentdela requete soitun ensemble d'objets (Java, par exemple) qui resumentlareponse 
a envoyer au cl ient. Cet ensemble d'objets J ava peut alors servir de base a la construction 
d'unarbreDOM representant un document X M L virtuel qui seralui memetransmis au 
thread XSLT pour etre transforms en HTML etrenvoye vers le client. 

Ce genre de solution fonctionne tres bien, mais a tendance a consommer des ressources 
sur I e serveur. II est certain que dans I 'ideal, il vaudraitmieux demanderauclientdefaire 
lui-meme la transformation XSLT, mais cen'est pas possible actuel I ement, a cause de la 
grande disparity des navigateurs vis-a-vis du support de X SLT 1.0 

Memeavec IE5, il faut installer le module M SXM L3 pour que cela fonctionne, sinon le 
dialecteXSL integrepardefautalE5 est tell ement el oignede XSLT 1.0, qu'on peut dire 
que ce n'est pas le meme langage. 

A ctuel I ement I a seule solution viable est done la transformation sur I e serveur, parceque 
e'est la seule qui permet de s'affranchir de la diversity des navigateurs ; il n'y a que si 
I'on travail le dans un environnement intranet, ou les postes clients sont configures de 
facon central isee, que I 'on peut envisagerdediffuser sur lereseau du XM L a transformer 
a I'arrivee. 

Processeurs courants 

L'API TrAX (Transformation API for XML) est une A PI qui permet de lancer des trans- 
formations XSLT au travers d'appels de methodesjava standard. JAXP (Java API for 
XML Processing), de Sun Microsystems, est une A PI complete pour tout ce qui est trai- 
tement XM L, et comporte une parti e « transformation » conforme aux specifications de 
TrAX. Les processeurs donti I est question ci-dessous implemented I 'A PI TrAX. 

En mode Serveur, on retrouve les deux processeurs Saxon etXalan, qui peuventtous les 
deux etre appeles depuis une application J ava, via des appels TrA X , et notamment depuis 
une servlet. Cocoon, produit par Apache, est un framework integrant, grosso modo, un 
serveur HTTP, un moteurdeservlets, etun processeur XSLT (Xalan). 
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Typologie des utilisations d'XSL 

II y aau moinstrois grands domaines oil le I angageXSL peutintervenir : 

• dans les applications Internet; 

• dans les applications documentaires ; 

• dans les applications d'echanges d'informations entre systemes heterogenes et repartis. 

La figure 1-2 montre une possible architecture d'application Internet, avec les divers 
endroits ou XSL peut (eventuellement) intervenir. Actuellement, la tendance est plutot 
d'utiliser XSL pour generer des pages HTML dynamiques, mais ce n'est qu'une ten- 
dance, et de nombreuses applications ont ete construites sur des architectures utilisant 
XSLT defacon plusimportante: il serait tout a fait possible d'i magi ner une architecture 
dans laquelle les objets metier de I 'application Internet sont connected a des gisements de 
donnees repartis (par exemple via J DBC), cette connexion sefaisant par I 'intermediate 
d'objets DOM (Document Object Model) qui sont adaptes et transformed par un ou 
plusieurs processus XSLT. 

Note 

La connexion via JDBC a une base de donnees est une possibility mais ce n'est pas la seule, car il y a des 
extensions, notamment avec Xalan et Saxon, qui permettent a une feuille de style de se connecter directement 
a une base de donnees relationnelle. 
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Les applications documentaires recouvrent un vaste champ d'applications qui nefont pas 
forcement partie du domaine strictement informatique; citons par exemple le domaine 
dela litteratureet les sciences humaines, avec des projetscommelaTEl (Text Encoding 
Initiative, www.tei-c.org) ou celui de la composition electronique (PDF, Postscript) de 
textes anciens ou modernes dans des langues peu communes (grec ancien, arabe ancien, 
Sanscrit, copte, ecriture hieroglyphique, etc.) : voir par exemple www.fiuxus-virus.com/fr/ 
what-critical.html . 

Dans un domaine plus familier aux informaticiens, XSL intervient dans les chaines de 
production plus ou moins automatisee de documentations techniques ou commercial es et 
marketing ; un exemple simple etant la production d'un document desynthese a parti rde 
donnees au format XML extraites d'une base de donnees, qui sont ensuite mises en 
forme par XSLT etXSL-FO, etdonnentau final un document PDF ou Postscript (voir la 
figure 1-1 , a la section Le langage xsl, page 2). 

II faut citer aussi DocBook (http://docbook.sourceforge.net), dont on reparlera d'ailleurs 
dans la suite de ce livre, qui est un systeme complet et gratuit pour rediger de la docu- 
mentation (rapports, articles, livres, documents structures, etc.) au format XML. 
DocBook delivre des sorties en HTM L (previsualisation) ou en FO, quel'on transforme 
ensuite en PDF, par exemple (cettedemiere transformation sefaisantgraceaun proces- 
seurFO commeFOP, XEP ouRenderX). 

E nfin, le domai ne de I 'echange de donnees entre systemes heterogenes et reparti s concerne 
plusieurscourantsd'activite, notamment celui del'EDI (Electronic Data Interchange, ou 
echange de donnees informati sees), del'EAl (Enterprise A pplication Integration), etdes 
Web Services ( www. w3.org/TR/wsdl, www.w3.org/TR/soap12-part1, www.xmlbus.com). 

Dans tousles cas, del 'information est echangee au format XM L, etdes transformations 
XSLT permettent d'adapter les donnees propres a un systeme pour les conformer a une 
syntaxe (DT D , X M L schemas, etc.) a I aquel I e adhere une certai ne communaute d' uti I i sa- 
teurs. 

Un avant-gout d'XSLT 

Donnerunapercudu langageXSLT n'est pas du tout evident. Pourun langage commeC 
ou Java, c'est assez facile de donner quelques exemples donnant une premiere impres- 
sion, parce que ce sont des langages qui ressemblent a d'autres : on peut done proceder 
par comparaison en montrant par exemple un programmeVisual Basic et son equivalent 
en Java, ou un programme Pascal et son equivalent en C. Pour XSLT, il n'y aaucun lan- 
gage un tant soit peu equivalent et a peu pres bien connu qui permette d'etablir une com- 
paraison. Seuls des langages fonctionnels ou declaratifs comme Prolog, Caml ou Lisp 
donnent une bonne base de depart qui permet de s'y retrouver, mais encore faut-il en 
avoir I 'experience... 

Si on nel'a pas, il n'est guere possible desefier a son intuition pour deviner I'effet d'un 
programme, notamment au tout debut de la prise de contact avec ce langage. 1 1 y a nean- 
moins un angle d'attaque, qui ne donne pas un panorama complet du langage, loin s'en 
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faut, mais qui permet au moins de voir certains aspects, et de comprendre dans quelles 
directions il faut partir pour comprendre cequ'i I y a a comprendre dans celangage. 

Nous allons done commencer par voir ce qu'on appelle une feuille de style simplifiee 
(Simplified Stylesheet) ou Litteral Result Element As Stylesheet, comme I 'appelle fort 
doctement la specification XSLT 1.0. 

L'avantage est qu'une feuille de style simplifiee utilise une version tenement bridee du 
langage X SLT que I 'on peut assez facilement deviner ce que fait une tel le feui lie de style 
sans quedes explications tres detail lees soi enforcement necessaires. 

M ais I'inconvenient est que I'on ne peut pas faire grand chose de plus que ce qu'on va 
montrerdanscetapercu. 

Remarque 

Une feuille de style simplifiee n'est jamais necessaire : il n'y a jamais rien ici que I'on ne puisse faire avec une 
vraie feuille de style. 

U ne feui lie de style simplifiee peut rendre service aux auteurs de pages HTML possedant 
peu de competences en programmation, dans la mesure ou eel a leur permet d'ecrire assez 
facilement des pages dynamiques. La seule contrainte a respecter absolument, qui 
contredit peut etre la pratique courante, est que le document HTM L a ecrire doit respec- 
ter la syntaxeXM L, e'est-a-dire qu'il faut employer du XHTM L : toute balise ouverte 
doit etre refermee, et les valeurs d'attributs doivent etre enfermees dans des apostrophes 
ou des guillemets. 

Avant de passer a I 'exemple proprement dit, insistons encore une fois sur le fait que cette 
notion de feuille de style simplifiee n'est presentee ici que pour vous donner une pre- 
miereideedulangageXSLT. II n'y a aucune autre justification a son usage, et pi us jamais 
nousn'en reparl erons dans la suite de eel ivre. A utant dire qu'une feui lie de style simpli- 
fiee n'a pas grand interet dans la pratique... 



Exemple 



Pour montrer comment generer une page dynamique avec une feuille de style simplifiee, 

nous al Ions prendre un exemple, et supposer que nous voulons obteni r une page telle que 

celle qui estmontreealafigurel-3. 

Cette page est produite a partir d'un fond qui comporte essentiellement de I'HTML 

XMLise: 

AnnonceConcert.xsl 

<?xml version="1.0"?> 
I <html xmlns:xsl="http://www. w3.org/1999/XSL/Transform" xsl :version="1.0"> 
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Figure 1-3 

Une page HTML 

a cn'ticrcr 
dynamiquement. 



Les «Concerts Anacreon» presentent 



Concert le Jeudi 17 Janvier 2002 20H30 

Chapelli; des Ursules 

Ensemble «A deux violes esgales» 

J onathan Dunford , Basse de viole 
SyivM Abramowicz , Basse de viole 

Freddy Echelberger , Clavecm 

Oeuvres de M. Marais, D. Castello, F. Rognoni 



/h 


ead> 








<H1 al 


gn=' 


center"> 




<hr/> 








<br/> 








<H1 al 


gn=' 


center"> 




Concert 


le <xsl 




</Hl> 







Les "Concerts Anacreon" presentent</Hl> 



a-of select="/Annonce/Date"/> 



<H4 align="center"> 

<xsl:value-of select="/Annonce/Lieu'7> 
</H4> 



<H2 align="ci 
Ensemble 
</H2> 



2-of select="/Annonce/Ensemble"/>" 



<xsl :for-each select="/Annonce/Interprete" 



Introduction 

Chapitre 1 



<xsl:value-of select=" ./Nom"/>, 
<xsl : value -of select=" . /Instrument "/> 
</p> 
</xsl:for-each> 

<H3> 

Oeuvres de <xsl :val ue-of select="/Annonce/Compositeurs"/> 
</H3> 



Ce fichier HTML est en realite un fichier X M L, comme le montre la premiere I igne, dont 
l'elementracineestl'element<htmi>, qui introduitdonc un document HTML. Lesdeux 
attributs accompagnant cet element sont obligatoires : si vous voulez ecrire votre propre 
exemple, vous pouvez recopier les deux premieres I ignes tell es quelles, sans vous poser 
de question. Le premier attribut est en fait une definition de domaine nominal, c'est-a- 
dire la definition d'un jeudevocabulai re identifie par une URL ad hoc, etabregeesousla 
forme d'un prefixequi estici xsi. CetteURL n'estpasdu tout utilisee en tantqu'URL, 
c'est juste une chalne de caracteres convenue qui represente symbol iquement lejeu de 
vocabulaire XSLT ; cette chaine de caracteres en forme d'URL a ete determined par le 
W3C, etleprocesseurXSLT qui va lire ce fichier neprend en compteen tantqu'instruc- 
tion XSLT que les elements XML dont leprefixe reference cette URL. II est done abso- 
lument impossible de changer quoi que cesoit a cette declaration de domaine nominal. II 
en est dememe pour I'attri but xsi rversion, du moinstant que la specification XSLT 2.0 
ne sera pas parvenue au stade de Recommendation : pour I'instant, done, la seule valeur 
possible est 1.0. 

Lerestedu fichier est essenti ell ementdu XHTML, avec 5a et lades instructions XSLT : 
^instruction <xsi :for-each>, et I'instruction <xsi :vaiue-of> dans I ecas present. 

Ces instructions ont pour but d'alimenter le texte HTM L en donnees provenant d'un 
fichier XML auxiliaire. Ces donnees ne sont pas directement presentes dans le texte 
XHTM L, afin depouvoir generer autant de pages differentes que necessai re, ayanttoutes 
le meme aspect : il suffit pour cela d'avoir plusieurs fichiers XML differents. 

Dans notre exemple, I e fichier XML auxiliaire est celui-ci : 



<Date>Jeudi 17 Janvier 2002 20H30 

</Date> 

<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble>A deux violes esgales</Ensemble> 
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<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

< I nstrument>Theorbe</ Instrument 
</Interprete> 

<Interprete> 

<Nom> Freddy Eichelberger </Nom> 

< I nstrument>Clavecin<7 Instrument 
</Interprete> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
</Compositeurs> 



La generation dela page HTM L dynamique consisted lancer un processeur XSLT en lui 
fournissantdeux fichiers : d'une part le fichier dedonneesXM L Annonce.xmi, etd'autre 
part le fichier programme AnnonceConcert .xsi . 

N ous supposons que nous sommes en mode Commande (voi r Mode Commande, page 5), 
et que le processeur choi si est Saxon. L a lignede commande pour obtenir la page HTML 
annonce.html serait alors celle-ci : 

Ligne de commande (d'un seul tenant) 

Java -classpath saxon.jar com. icl .saxon. Stylesheet 

-o annonce.html Annonce.xmi AnnonceConcert. xsl 

Note 

Ceux qui ne voudraient pas installer une machine virtuelle Java pourraient utiliser ici Instant Saxon. 

Et le fichier obtenu serait celui-ci (voir aussi la figure 1-3) : 

Annonce.html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8"> 
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<title>Les «Concerts Anacréon»</title> 
</head> 
<body> 

<H1 al ign="center">l_es «Concerts Anacréon&raquc 
présentent</Hl> 
<hr><br><Hl al ign="center"> 

Concert le Jeudi 17 Janvier 2002 20H30 

</Hl> 

<H4 align="center">Chapelle des Ursules</H4> 
<H2 align="center"> 

Ensemble «A deux violes esgales» 



</H2> 

<p> Jonathan 


Dunford , 

Basse de viole 




</p> 






<p> Sylvia Abramowicz , 






Basse de viole 




</p> 






<p> Benjamin 


Perrot , 

Théorbe 




</p> 






<p> Freddy E 


ichelberger , 

Clavecin 




</p> 






<H3> 


Oeuvres de 




M. 


Marais, D. Castello, 


". Rogn 


</H3> 






</body> 






/html> 







Avantdecontinuer, il fautici faireuneremarqueimportante: le document source, malgre 
les apparences, est le fichier XML Annonce.xmi ; le processeur XSLT transforme ce 
document XML en un document HTML annonce.html, par I 'intermedial re d'un pro- 
gramme XSLT contenu dans le fichier AnnonceConcert.xsi : le fichier auxiliaire de 
donnees est en fait, du point de vue XSLT, le document principal, et ce qui semblait 
n'etre que le modele de fichier HTM L a produire est en realite le programme XSLT a 
executer. 

Extraction individuelle (pull processing) 

Regardonsmaintenantdepluspreslefonctionnementdu programmeXSLT : il estessen- 
tiellement base sur le principe de I 'extraction individuelle (connu en anglais sous le nom 
de pull processing). Typiquement, le debut du programme est entierement base sur ce 
principe: 
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<head> 

<title>Les "Concerts Anacreon"</title> 
</head> 
<body> 

<H1 align="center">Les "Concerts Anacreon" presentent</Hl> 

<hr/> 

<br/> 



<H1 align="c 


nter"> 


Concert 


e <xsl :val ue-of select="/Annonce/Date 


</Hl> 




<H4 align="c 


nter"> 


<xsl:val 


e-of select="/Annonce/Lieu"/> 


</H4> 




<H2 align="c 


nter"> 


Ensemble 


"<xsl :value-of select="/Annonce/Ensem 


</H2> 





Tout cetexte est recopietel quel parleprocesseurXSLT dans le document HTML resul- 
tat, a I'exception des instructions <xsi :vaiue-of> qui sontdes instructions d'extraction 
individuelle: elles sont done remplacees par leur valeur, valeur qui est prelevee (ou 
extraite, d'ou cette notion d'extraction individuelle) danslefichierdedonneesXML. 

Le langage XPath 

Le probleme est naturellement de definir a quel endroit du document X M L se trouve la 
donneeaextraire. C'est la qu'intervientle langage XPath, qui permet de referencer des 
ensembles d'elements, d'attributs et de textes figurant dans un document XML. 
Par exemple, I'expression XPath /Annonce/Date selectionne tous les elements <Date> 
qui se trouvent directement rattaches a un element <Annonce> racine du document. Si 
vous regardez le document XML, vous verrez qu'il n'y en a qu'un qui reponde a la 
description. L'instruction : 

<xsl :value-of select="/Annonce/Date"/> 

sera done remplacee par sa valeur, e'est-a-dire par letexte trouve dans I'element <Date> 
selectionne, asavoir : 
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Remarque 

L'analogie entre une expression XPath telle que /Annonce/Date et un chemin Unix d'acces a un fichier a 
souvent ete soulignee. Dans notre exemple, I'expression XPath lue comme un chemin Unix voudrait dire « le 
fichier (ou repertoire) Date se trouvant dans le repertoire Annonce situe a la racine du systeme de fichiers ». 
Cette analogie est a mon avis plus dangereuse qu'utile. En effet il y a une enorme difference entre une arbores- 
cence de fichiers et une arborescence d'elements XML : il ne peut jamais y avoir deux fichiers ayant le meme 
nom dans un meme repertoire, alors qu'il peut fort bien y avoir plusieurs elements de memes noms rattaches au 
meme element. Dans notre fichier XML d'exemple, voyez comment interpreter I'expression /Annonce/Inter- 
prete : il s'agit de I'ensemble de tous les elements <Interprete> directement rattaches a la racine 
<Annonce>. Cette possible multiplicite d'elements intervient a tous les niveaux : dans une expression comme 
/Annonce/Interprete/Instrument, rien n'interdit qu'il y ait plusieurs <Interprete> par <Annonce> (deja 
vu), et plusieurs <Instrument> par <Interprete> (il n'y a pas d'exemple dans notre fichier XML, mais cela 
pourrait arriver : voir plus bas). 

La consequence, et c'est la ce qu'on voulait montrer, est qu'il est des lors impossible de lire une expression 
XPath comme on lirait un chemin Unix : c'est en cela que l'analogie est mauvaise et nocive. Un chemin Unix se 
lit normalement, de gauche a droite. Mais le meme chemin, considere comme une expression XPath, doit se lire 
a I'envers, car c'est le seul moyen de preserver la multiplicite des elements selectionnes : /Annonce/Inter- 
prete/Instrument doit se lire « les instruments qui sont rattaches a des interpretes qui sont rattaches a la 
racine Annonce ». 



En appliquant cette instruction xsi:vaiue-of aux divers chemins XPath concernes, on 
voit done facilement que le fragment de programme ci-dessus va produire le resultat 
suivant : 

<head> 

<title>Les "Concerts Anacreon"</title> 
</head> 

<body> 

<H1 align="center">Les "Concerts Anacreon" presentent</Hl> 

<hr/> 

<br/> 

<H1 align="center"> 

Concert le Jeudi 17 Janvier 2002 20H30 
</Hl> 

<H4 align="center"> 

Chapelle des Ursules 
</H4> 

<H2 align="center"> 

Ensemble "A deux violes esgales" 
</H2> 



Un avant-gout d'XSLT 

Chapitre 1 



La suite du programme comporteune repetition < 

<xsl :for-each select="/Annonce/Interprete"> 
<P> 

<xsl :value-of select="./Nom"/>, 



lei, I'instruction <xsi :for-each> selectionne un ensemble d'elements XML contenant 
tous les <interprete> directement rattaches a la racine <Annonce> ; et dans le corps 
decette repetition, on dispose d'un element courant, qui est bien sur un <interprete>, 
quel'on peut referencer dans une expression XPath par la notation wAinsi, I 'expres- 
sion Xpath "./Nom" veut dire: «tous les <Nom> rattaches directement a I 'element 
<interprete> courant ». Commeun tel <Nom> est unique, I'instruction : 

<xsl:value-of select="./Nom'7> 

est done remplacee par la valeur du nom de I 'interprete courant, et i I en est de meme pour 
I'instruction : 

<xsl:value-of select=". /Instrument"/) 

A u total, cette repetition produit la sequence suivante dans le document resultat : 

<p> Jonathan Dunford , 

Basse de viole 



</p> 




<p> Sylvia 


Abramowicz , 




Basse de 


</p> 




<p> Benjam 


n Perrot , 




Th&eacute 


</p> 




<p> Freddy 


Eichelberger . 



Finalement, on obtientdonc lefichier HTM L dejamontre plus haut. 

Autre exemple 

Les feuilles de style simplifies se resument en gros a ce qu'on vient de voir ; il n'est 
guere possible defaire plus, a part uti User quel ques instructions XSLT complementaires, 
par exemple un <xsi :if>. Pour illustrerceci, supposonsmaintenant que lefichier XML 
a traiter soit constitue ainsi : 
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<Date>Jeudi 17 Janvier 2002 20H30 

</Date> 

<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble>A deux violes esgales</Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Mom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

< I nstrument>Theorbe</ Instrument 

< I nstrument>Luth</ Instrument 
<Instrument>Chitarrone</Instrument> 
<Instrument>Vihuela</Instrument> 

< I nstrument>Angelique</ Instrument 
</Interprete> 

<Interprete> 

<Nom> Freddy Eichelberger </Nom> 
<Instrument>Clavecin</Instrument> 

</Interprete> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 



Leproblemeatraiter, ici, est qu'il peuty avoir une I isted'instruments pour chaqueinter- 
prete. On veut que le resultat soit celui montre a la figure 1-4. 

Fondamentalement, il n'y a rien de change au programme. Simplement, il vafalloir pla- 
cer une deuxieme instruction de repetition, pour donner la liste des instruments par inter- 
prete, ce qui complique un peu les choses, car une liste implique la presence de 
separateursd'elementsfici, c'estunevirgule). 

Cette virgule doit apparaitre apres chaque nom d'instrument, sauf le dernier : d'ou la 
necessite d'utiliser une instruction <xsi :if> qui va nous dire si l'<instrument> courant 
est I e dernier ou non. 
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Figure 1-4 
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AnnonceConcert.xsl 

<?xml version="1.0" ?> 

<html xmlns:xsl="http: //www. w3.org/1999/XSL/Transforir 
xsl:version="1.0"> 

<head> 

<title>Les "Concerts Anacreon"</title> 
</head> 



<body> 

<H1 align="ce 

<hr/> 

<br/> 

<H1 align="center"> 

Concert le <xsl :\ 
</Hl> 



'>Les "Concerts Anacreon" presentent</Hl> 



2-of select="/Annonce/Date"/ 



<H4 align="center"> 

<xsl:value-of select="/Anr 
</H4> 
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Ensemble "<xsl :val ue-of select="/Annonce/Ensemble"/>" 
</H2> 

<xsl :for-each select=VAnnonce/Interprete"> 
<P> 

<xsl:value-of select=" ./Nom"/> 
<xsl:text> ( </xsl:text> 
<xsl :for-each select=" ./Instruments 
<xsl:value-of select="."/> 
<xsl:if test="position() ! = last()"> 

<xsl:text>, </xsl:text> 
</xsl:if> 
</xsl:for-each> 
<xsl:text> ) </xsl:text> 
</p> 
</xsl :for-each> 



<H3> 



</body> 
</html> 



2lect="/Annonce/Conipositeurs"/> 



ICi la premiere instruction de repetition <xsl :for-each select="/Annonce/Inter- 

prete"> selectionne un ensemble d'elements <interprete>, et chacun d'eux devient tour 
atourl'<interprete>courant, note "." danslesdeux premiers attributs select qui vien- 
nentensuite: 

• seiect="./Nom" : selectionne tous les <Nom> qui sont directement rattaches a 
l'<interprete> courant (il n'y en a qu'un) ; 

• seiect=". /instrument- : selectionne tous les <instrument> qui sont directement 
rattaches a l'<interprete> courant (il peuty en avoir plusieurs). 

La deuxieme instruction de repetition <xsi :for-each> produit done une liste d'instru- 
ments, en copiantdans le document resultat le texte associe a I '<instmment> courant, et 
en lefaisant suivre d'une virgule, sauf si l'<instmment> courant est le dernier de la liste. 
Par ailleurs on remarque I'utilisation de instruction <xsi :text>. Cette instruction est 
tres utile, maisson rolerestetresmodeste, entoutcasici. E lie sert a deli miter exactement 
un texte litteral a produire dans I e document resultat, sans que des espaces, tabulations, et 
autres sauts de ligne ne viennent s'aj outer defacon intempestive au resultat. 

La difference entre: 



<sl:value-of select^" ./Nom"/> 
<xsl:text> ( </xsl:text> 



le-of select="./Nom"/> 
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est que dans le premier cas, on voit qu'il y a exactement un espace avant la parenthese, 
alors que dans le deuxieme, on voit qu'il y en a plusieurs (combien ? difficile a dire) et 
qu'il y a aussi un saut de ligne. On pourrait se passer de instruction <xsi :text> en 
ecrivant : 

<xsl :val ue-of select=" ./Nom"/> ( <xsl :for-each select=" ./Instrument") 

mais ce n'est pas tres agreable, car cela impose la presentation du programme en empe- 
chantde placer dessautsdelignesouon veutafin d'aerer la disposition. 

Voici pourfinir lefichier HTM L obtenu (on pourra comparer avec la figure 1-4), en deux 
versions : la premiere obtenue avec le programme XSLT tel qu'il apparait avant (fichier 

AnnonceConcert .xsl ) : 

annonce.html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8"> 

<title>Les &1 aquo;Concerts Anacréon»</title> 
</head> 
<body> 

<H1 al ign="center">Les &1 aquo;Concerts Anacréon» 

présentent</Hl> 
<hr><brXHl align="center"> 

Concert le Jeudi 17 Janvier 2002 20H30 

</Hl> 

<H4 align="center">Chapelle des Ursules</H4> 

<H2 align="center"> 

Ensemble «A deux violes esgales» 

</H2> 

<p> Jonathan Dunford ( Basse de viole ) </p> 
<p> Sylvia Abramowicz ( Basse de viole ) </p> 

<p> Benjamin Perrot ( Théorbe, Luth, Chitarrone, Vihuela, Angelique ) 
</p> 



<p> Freddy 


Zichelberger 


( Clavec 


n ) </p> 


<H3> 


Oeuvres de 






M 


Marais, D. 


Castello, 


F. Rognon 


</H3> 








</body> 








</html> 
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Et la deuxieme version : 

annonce.html 

<html> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=utf-£ 

<title>Les «Concerts Anacréon»</title> 
</head> 
<body> 

<H1 al ign="center">Les «Concerts Anacréon» 

présentent</Hl> 
<hr><br><Hl align="center"> 

Concert le Jeudi 17 Janvier 2002 20H30 

</Hl> 

<H4 align="center">Chapelle des Ursules</H4> 
<H2 al ign="center"> 

Ensemble «A deux violes esgales» 

</H2> 

<p> Jonathan Dunford 



</p> 
<p> Sylv 



Basse de viole 



</p> 

<p> Benjamin Perr 



Théorbe 

Luth 

Chitarrone 
Vihuela 
Angel i que 



<p> Freddy Eichelberger 
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s, D. Castello. F. Rognoni 



</p> 
<H3> 



</H3> 
</body> 
</html> 

Cette deuxieme version est obtenue en supprimant les instructions <xsi :text> du pro- 
gramme precedent, comme ceci : 

<xsl :for-each select="/Annonce/Interprete"> 
<P> 

<xsl :value-of select=" ./Nom"/> 
( 

<xsl :for-each select^" ./Instruments 
<xsl :val ue-of select=". "/> 
<xsl:if test="position() != last()"> 



Conclusion 

Nousvenonsdevoircequ'on peut f ai re avec la notion defeuilledestylesimplifiee. Cela 
se resume a de I'extraction individuelle (pull processing), agrementee de la possibilite 
d'utiliser quelques instructions d'XSLT, permettant defai redes repetitions, des tests, des 
choix multiples, et quelques autrestraitementscomplementaires. 
M ais il manque essentiellement le pendant de I'extraction individuelle, qui est la distri- 
bution selective (ou push processing), qui donne toute sa puissance a X SLT (mais qui en 
faitaussi la difficult). II manque egalement des instructions qui sont interdites (ou plutot 
impossibles) avec I es f eui 1 1 esde style simplifies, notammenttoutes les instructions dites 
de premier niveau : cela inclut la declaration de variables globales, de cles associatives 
(<xsi :key>), d'instructions d'importation d'autres feuilles de style, et la definition de 
model es nommes (qui sont des structures jouant a peu pres le meme role que les fonc- 
tions ou les sous programmes dans les autres langages). Avouez que cela finit par faire 
vraiment beaucoup, et que dans ces conditions, les feuilles de style simplifies n'ont pas 
beaucoup d'interet, a part d'etre tres simples et faciles a comprendre intuitivement. M ais 
pour quelqu'un qui connalt bien XSLT, on peutaller jusqu'a dire qu'elles n'ont state- 
ment aucun interet par rapport aux vraies feuilles de style XSLT. 

N ous avons vu au passage que le langage X SLT possede son propre jeu d'instructions, au 
format X M L, mais identifie par ledomaine nominal http://www.w3.org/i999/xSL/Transform ; 
et qu'on y utilise un autre langage, le langage XPath, qui n'a rien a voir avec XML. 
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Celangage, qui permet de selectionner divers ensembles de fragments d'un document 
XML, est en fait nettement plus complique que cequ'on a pu montrer dans lesexemples 
precedents, et il faudra un gros chapitre pour en venir a bout. 

Parcours de lecture 

Nous venons devoir I'interetdu langageXSLT, aquoi il sertetou il sesitue. Bien que 
partie integrante deXSL, XSLT estun langagequi peutetre considers commeindepen- 
dant. De plus il est extremement different, dans sa philosophie et dans les competences 
qu'il met en jeu, du langageXSL-FO, I'autreversantdeXSL. 

C'est pourquoi dans la suite de ce livre, on se consacrera exclusivement a XSLT lui- 
meme, et a son compere X Path. 

Nous verrons done d'abord XPath, puis les principes du langageXSLT. Le style adopte 
estun style a I 'oppose d'un manuel dereference, en cesensqu'on cherche plus a favori- 
ser la comprehension du sujet que I 'exhaustivite du propos. M ais ceci doit etre tempere 
par le fait que pi us on avancedansla lecture, et plus on en sait : on est done plusameme 
d'accepterdes details ou dessubtilites vers la fin dela presentation que vers le debut. 
Si vousetespresseetvoulez lire I 'essentiel pour comprendre XSLT, sans entrer dans les 
details, et pour comprendre le mode de pensee a adopter pour etre en phase avec ce Ian- 
gage, il n'y aqu'un chapitre a lire : I e chapitre Au cceur du langage XSLT, page 75. 

Apres avoir fait le tour de la plus grande partie du langage en quelques chapitres, on 
s'interessera a la notion de « pattern » de conception XSLT, en mettant en evidence des 
grands themes qui reviennent frequemment, aussi bien dans le domaine microscopique 
de la programmation par des techniques parti culieres, que dans celui plus macroscopique 
de la transformation d'arbres. 

Enfin, dans les annexes, on trouvera des elements complementaires, notamment la des- 
cription sommaire de quelques instructions dont la comprehension ne pose pas de diffi- 
culte particuliere, ou dont la comprehension est plus du resso rt de tests effectifs avec un 
processeur XSLT que de celui d'une lecture argumentee. On y trouvera aussi des ele- 
ments syntaxiques, etune description des fonctions predefines XPath etXSLT. 

A noter que dans ce livre, les exemples fournis ont tous ete testes avec les processeurs 
X alan et Saxon, et que le mode de fonctionnement sous-jacent des exemples proposes est 
lemodeCommande; cela n'aaucune influence sur I a semanti que du langage XSLT, mais 
eel a permet de fixer les idees. 
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Guide de lecture 

Chapitre XPath 

Le chapitre sur XPath est globalement tres important pour la comprehension du reste. 
Notamment, il est absolument indispensable d'avoirtoujours present a I'esprit le modele 
arborescent d'un document XML VU par XPath [Modele arborescent d'un document 
XML vupar XPath, page 30), car ce modele est a la base de tous les raisonnements divers 
et varies en XSLT. 

L a section suivante, XPath, un langage d' expressions, page 40, peut etre ignoree en pre- 
miere lecture. Certains passages, dans la suite du livre, y font reference, et on pourra 
eventuellement attendre d'y etre invite ou d'avoir un probleme lie a I'ecriture ou la lec- 
ture d'une expression pour aller voir cette section. Dans beaucoupdecas simples, I'intui- 
tion peutsuffire, au moins pour lire une expression. 

Les trois sections SUivantes (Principes de la construction d'un chemin de localisation, 
page 47, Etape de localisation, page 48, Chemins de localisation, page 62) represented 
le cceur d'XPath : elle sont essenti el I es pour la comprehension d'XPath et d'XSLT. 

Notamment la Section Lecture d'un chemin de localisation sans predicat, page 64, in- 

dique un algorithme pour lire les chemins X Path ; cela aide beaucoup au debut, quand on 
n'a pas encore I'habitude de manipuler les etapesde localisation. 

La Section SUivante, Formes courtes des chemins de localisation, page 68, indique les 

abreviations standards utilisees en XPath. Cette section est egalement incontournable, 
car ces abreviations sont presque toujours utilisees dans la pratique. 

La derniere section, Variantes syntaxiques, page 70, pourra etre sautee en premiere lec- 
ture, car elle donne des elements assez subtils, indispensables a mettre en ceuvre dans 
certains cas, mais heureusement assez rares. 

Chapitre Au cceur d'XSLT 

Ce chapitre est le chapitre essentiel pour la comprehension generale du langage XSLT. 
II s'opposefortement a I 'introduction vue a la section Un avant-gout d'XSLT, page 9, en 
ce sens que I'on ne fait pas appel ici a I'intuition, mais qu'au contraire, on demonte le 
mecanisme de traitement specifie par X SLT. Ce chapitre, une fois lu, permet la compre- 
hension globaledetoutXSLT : le reste est constitue d'ajouts, defacilites, dedetails, etc., 
mais il n'y a aucun mecanisme fondamentalement nouveau. Seules trois instructions y 
serontvues : xsi template, xsi :vaiue-of, etxsi :appiy-tempi ates, parce qu'elles sont 
au cceur du modele de traitement, de meme que la notion de motif et de concordance de 
motif (pattern matching), qui sera vue de facon tres detail lee a cette occasion. 

Chapitres sur les instructions XSLT (transformation, programmation, creation) 

Le modele de traitement du langageXSLT etantvu, lerestedu langage consiste en divers 
ajouts (des instructions) permettantd'exploiter pleinement la puissance dece modele de 
traitement. II est alors possible de grappiller en fonction des besoins, bien que les trois 
chapitres soient organises de telle sortequ'il n'y ait pas dereferences avant. Une lecture 
I i neai re est done recommandee, mais el I e n'est pas obi i gatoi re. 



Ces instructions sont classees en trois categories: transformation, programmation et 
creation. Chaque categorie correspond a un chapitre. Ces trois chapitres sont presented 
suivant un plan assez regulier, dans lequel chaque instruction (mis a part quelques ins- 
tructions COmmexsl : template, xsl :value-of, etxsl :apply-templ ates, qui neSOntpaS 

concernees parce qu'elles ont ete deja vues au chapitre Au cceur du langage XSLT, 
page 75, ou quelques autres qui sont extremement simples) sera presentee comme ceci : 

• bande-annonce; 

• syntaxe; 

• regie X SLT typique; 

• semantique; 

• exemples divers; 

• eventuel I ementvari antes syntaxiqueset exemples. 

La section bande-annonce donne un apercu de I'instruction sur un exemple simple, le 
plus souvent (mais pas toujours) repris plus loin dans la suite des explications. Cette 
bande-annonce permet de sefaire rapidement une idee intuitive de I 'instruction. 

La section syntaxe donne la forme de I 'instruction avec I es eventuel I es contraintesa res- 
pecter. 

La section regie XSLT typique donne une forme de regie XSLT (xsi : tempi ate) dont le 
model ede transformation emploietypiquement I 'instruction decrite. 

La section semantique indique I'effet de I'instruction, c'est-a-dire la facon dont elle est 
instanciee. 

Les exemples viennent ensuite: certains sont directs, d'autres sont I'occasion de 
quelques digressions induites par des difficult.es inattendues. 

Les variantes syntaxiques introduisent generalement des possi bi lites nouvelles offertes 
par des attributs facultatifs de I'instruction decrite. 

Si I'on est presse et que I'on souhaite se contenter d'une lecture de premier niveau, on 
pourra se contenter de lire la bande-annonce, la syntaxe, la regie XSLT typique, et de 
Jeter un coup d'ceil a la semantique; si I'on n'estpas presse ou que I'on revient sur cette 
instruction apres avoir bute sur une difficult^, on pourra lire la semantique plus en detail, 
et analyser les exemples qui viennent ensuite. 

Chapitre Decoupage d'une application XSLT 

Ce chapitre est un peu a part, dans la mesure ou il n'apporte aucune fonctionnalite nou- 
velleau langage XSLT, si ce n'est la facon dedecouper une application XSLT, soit pour 
la rendre plus facilement maintenable, soit pour rendre reuti I i sables certains de ses 
constituants. C'est done plutot un chapitre donnant quelques elements de Genie Logici el 
en XSLT, qui peut evidemment etre ignore en premiere lecture si votre but est unique- 
ment, dans un premier temps, la realisation de transformations XSLT. 
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Le langage XPath est standardise sous la forme d'une «W3C Recommendation » du 
16 novembre 1999. 

Cen'estpasun langage de la familleX ML : c'estun langage d'expression permettantde 
constituer des ensembles de nceuds provenant de I'arbre XML d'un document. XPath 
intervientdansXSLT d'une facon tellement intriquee, qu'on pourraitcroirequ'il nefait 
qu'un avec XSLT. Mais en fait, c'estun langage a part, parcequeleW3C en a fait une 
brique intervenant dans d'autres langages, comme par exemple XPointer (pour XSLT 
1.0) ouXQuery (pour XSLT 2.0). 

C'est un langage assez simple dans sa structure, puisqu'il se limite a des expressions, 
mais ^interpretation de certaines expressions (complexes ou non) peut parfois etre assez 
subtile. Heureusement, dans la pratique, les expressions XPath que I'on doit manipuler 
sont general ement assez simples, eten toutcas, deviennent assez vitefamilieres. 

Pour voir comment fonctionne X Path, il faut d'abord comprendre sur quoi repose son 
fonctionnement. X path etant fait pour traiter des documents XM L, i I utilise un model ede 
representation arborescente d'un document XML, qui conditionne tout le reste; nous 
commencerons done par voir cemodeled'arbre. Ensuite, nous verrons comment chemi- 
ner dans un tel arbre, avec la notion de chemin de localisation, notion centrale de X Path, 
i mpl i quant el I e-meme d'autres noti ons pi us elemental res, tel I es que les axes de localisa- 
tion, les determinants, et les predicats. Ces elements sont les ingredients de base pour 
ecrire tiesetapes de localisation, dont I'enchainement donne des chemins de localisation 
qui peuvents' interpreter en termesd'ensemblede nceuds del 'arbre traverse : XPath spe- 
cifie comment ecrire des chemins de localisation, et comment les interpreter pour obtenir 
des ensembles de nceuds. 
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Modele arborescent dun document XML vu par XPath 

Nous allons expliquer ici comment XPath « voit » un document X M L, c'est-a-direetu- 
dier la structure arborescente utilisee par X Path pour modeliser un document XML. Le 
modele arborescent utilise par XPath n'est pas necessairement celui qui est reellement 
implemente en memoire lors de I'execution d'un processeur XSLT ; c'est un modele 
conceptuel qui permet de fixer I es idees et d'expri mer commodement les proprietes de ce 
langage. 

L'arbre manipule par XPath n'est pas different de I'arbre XML du document; simple- 
ment, des precisions sontapporteessur la nature de certains liens parent-enfant, ainsi que 
sur la nature des nceudsde I'arbre. 
1 1 y a sept types de nceuds possibles dans un arbre : 

• root : le type du nceud racinede I'arbre XM L du document, a ne pas confondre avec 
I 'element racinedu document, qui estun element commeun autre, a part qu'il n'a pas 
d'element parent. L'element racine fait partie du document XML, alors que la racine 
root de I'arbre n'a pas decontrepartie visible dans le document XM L. 

• element : le type d'un nceud element X M L . 

<xxx> . . .</xxx> 

• text : le type d'un nceud textefaisant partie d'un element. 

... blabla ... 

• attribute : le type d'un nceud attribut d'element X M L . 

surface='12m2' 

• namespace : le type d'un nceud domaine nominal permettant de qualifier les noms 
d'attributsou d'elements intervenantdanscertaines parties d'un document XM L. 

xmlns:txt=" http://www.w3c.org/xml/schemas/Basic-text.dtd" 

• processing-instruction : le type d'un nceud processi ng-i nstruction (directive de 
traitement), en principe adressee a un programme autre que le processeur XSLT lui- 
meme. 

<?cible argl arg2 . . . ?> 

• comment : le type d'un nceud commentaire X M L . 
<!-- ... --> 

II est possible d'obtenir la valeur textuelle de n'importe quel nceud ; eel a semble evident 
pour un noeud detype text ou attribute, mais c'est aussi possible pour tous les autres 
types. Parfois la valeur textuelle d'un nceud ne depend que du nceud en question, mais 
parfois el I e depend aussi de ses descendants (cas d'un nceud de type element) ; cela 
depend en fait du type de nceud : un algorithme sera done donne pour chaque type, per- 
mettant decalculer cette valeur textuelle. 
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Nceud de type root 



Bien sflr, un seul nceud peut etre de type root. A la racine sont attaches, dans un lien 
parent-enfant : I 'element raci ne du document XML proprement dit (que I 'on trouve apres 
le prologue), les instructions de traitement et les commentaires qui interviennent dans le 
prologue et apres la fin de I 'element racine du document XML (voir la figure 2-1). 



<?xml version='1.0' encoding-' ISO-8859-1' 
<!D0CTYPE passacaille SYSTEM "Danse.dtd" ) 
<?play audio armide.avi?> 



- fin du document - 



Figure 2-1 

Un nceud de type 




play audio armide.avi 



La valeur textuelle du nceud de type root est la concatenation des valeurs textuelles de 
tous ses nceuds descendants pris dans I'ordre de lecture du document. 

Nceud de type element 

1 1 y a un nceud de type ei ement pour chaque element <xxx> du document X M L . A un 
nceud de type ei ement sont attaches, dans un lien parent-enfant: les nceuds de type ele- 
ment, enfants directs del 'element considere, les nceuds de type processing instruction, 
comment, et text qui font partie du contenu del 'element considere (voir la figure 2-2). 
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<cuisine> 



Lavabo. Cumulu: 
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en pierre. Poutres au plafond. 
j terre cuite. Grande baie vitree. 



Bibl iotheque encastree. 






</bureau> 






<garage/> 






<!-- pas de donnees disponible 


j sur le gar 


age 


Dans la cour : palmier en zinc 


figurant 1 


e d 


(demontable). 






</RDC> 








Figure 2-2 

Un naeud de type element. 



La valeur textuelle d'un nceud de type el ement est la concatenation des valeurs textuelles 
de tous ses descendants de type text (pas uniquement les enfants directs, mais seul ement 
lesnoeuds text) prisdans I'ordre de lecture du document. L'exemplequi suitconcernele 
document montre ci-dessus : 
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valeur textuelle de <RDC> 

Rez de chaussee au meme niveau que la rue, vaste et bien eclaire. 
Evier inox. Mobilier encastre. 

Lavabo. Cumulus 200L. 



Cheminee en pierre. Poutres au plafond. 
Carrelage terre cuite. Grande baie vitree. 



ic, figurant le desert 



Cette valeur textuelle comporte beaucoup de lignes blanches, et nous verrons pourquoi 
un peu plus loin. 

Nceud de type attribute 

Chaque nceud de type el ement possede un ensemble associe de nceuds de type attn - 
bute. Ces noeuds detype attribute sont attaches au nceud element considers par un lien 
special : I 'element est parent des noeuds attributs, mais les noeuds attributs ne sont pas 
enfants de leur parent. En d'autres termes, I 'ensemble des enfants d'un element ne 
contient pas ses attributs, mais pourtant, chaque attri but a un parent, qui est I 'element 
pour lequel I'attribut est defini. Un nceud attri but n'a pas d'enfant. Si I 'attri but sert a 
declarer un domaine nominal, cen'estpas un nceud detype attribute qui estcree, mais 
un nceud detype namespace. La figure 2-3 montreun exemplede nceud attribute. 



Figure 2-3 

Un nceud de type 

(Utribuie. 



r element -. 

[ cuisine j 
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La valeur textuelle d'un nceud de type attribute est tout simplement la valeur de cet 
attribut. 

Nceud de type namespace 

Chaque element possedeun ensemble dedomainesnominaux utilisables (mais pasforce- 
ment utilises) : ce sont les domaines nominaux declares par cet element ou I'un de ses 
ancetres, et non redefinis entre-temps le long de la hierarchie. Un nceud de type name- 
space est cree, pour chaque element, et pour chaque domaine nominal visible. Comme 
pour un nceud de type attribute, I 'element est le parent du nceud de type namespace 
ainsi cree, mais pourtant ne le possede pas en tant qu'enfant : voir la figure 2-4. 



^element-. 

I resume j 

a pour parent 



http://www.w3c.org/xml/schemas/Basic-text.dtd 

r element -. 
[ alinea j 

a pour parent 



http://www.w3c.org/xml/schemas/Basic-text.dtd 



http://www.duralex.fr/salaries/cdd.html 



Figure 2-4 

Des nceuds de type namespace. 
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xmlns:jur="http: //www. duralex.fr/salaries/cdd.html"> 



La valeur textuelle d'un nceud de type namespace est tout simplement la valeur de ce 
domaine nominal. 

Nceud de type processing-instruction 

Un noeud de type processing-instruction est cree pour chaque instruction de traite- 
ment, sauf si elle intervienta I'interieur dela partie DTD du document. Un noeud de type 
processing-instruction n'a pasd'enfant: voir la figure 2-5. 



Figure 2-5 

Un naud de type 
processing 

instruction. 



/-element-^ 

IpassacailleJ 



_ processing _ 
instruction 



play audio armide.avi 



La valeur textuelle d'un nceud detype processing-instruction est la chaine de carac- 
teres comprise entre le nom de I'instruction (exclu) et le ?> final (exclu). Dans notre 

exemple, CeseraitdonC audio armide.avi. 



Nceud de type comment 

Un nceud detype comment est cree pour chaque commentai re, sauf s'il intervienta I'inte- 



rieur dela partie DTD du document. Un nceud detypec 
figure 2-6. 



int n'a pasd'enfant: voir la 
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<!-- debut de la passacaille --> 
j </passacaille> 

Figure2 - 6 r element^ 

Unn^uddetype passacaille 

comment. v -f y 



debut de la passacaille 



La valeur textuelle d'un nceud de type comment est la chaine de caracteres comprise entre 
le debut et la fin du commentaire ( <!-- et -->exclus) . Dans notre exemple, ce serait 

done debut de la passacaille, 

Nceud de type text 

Chaque nceud detypeeiement peut avoir des nceuds enfants de type text. II n'y ajamais 
deux nceuds de type text cote a cote parmi les enfants du nceud element parent, car un 
nceud text est toujourscree d'un seul tenant, detelle sorte que lenombre total de nceuds 
text enfants du nceud element considers soit minimal, et que la taille de chacun d'eux 
soit maximal. Un nceud de type text n'a pasd'enfant: voir la figure 2-7. 



blabla 

<yyy> ... </yyy> 

suite du blabla 



Figure 2-7 

Deuxnaudsdetype 



text 

blabla 
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En general, la representation arborescented'un documentXM L necontenantpasdetexte 
apparent comporte tout de meme des nceuds text (II suffit pour cela que le document 
XML soit indente pour en ameliorer la lisibilite) : 



<yyy> 



Dansce documentXM L, il y a des sauts de lignes (puisqu'il y amanifestementplusieurs 
lignes) et des tabulations ou des espaces (puisque les lignes sont manifestement inden- 
tees). Ces caracteres (saut de ligne, espace, tabulation) sont connus sous I'appellation 
generique d'espaces blancs (white space en anglais) ; ces espaces blancs etant des carac- 
teres, ils donnent, comme les autres, naissance a des nceuds text (voir figure 2-8). 



Figure 2-8 

Des naudsde type 
text qu 'on 
n'attendait pas. 




a pour parent 
- attribute 7 



Dans la figure 2-7, le premier nceud text contient done plus que caracteres qu'il n'y 
parait : sautde ligne, tabulation, blabla, saut de ligne, tabulation. C 'est pour la meme rai- 
son que la valeurtextuelle del 'element <rdc> montreala section Naud de type element, 
page 31 est parseme de lignes blanches. 
La valeur textuelle d'un nceud de type text est tout simplement la valeur de ce texte. 
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Exemple d'arbre XML d'un document 



On prend ici comme exemple un document XML de description d'une maison (dans le 
style agenceimmobiliere), eton montrel'arbreXML correspondant, tel qu'il seramani- 
pule par X Path (voir figure 2-9) : 



Maison.xml 






<maison> 






<RDC> 






<cuisine surfa 
Evier inox 


:e='12m2'> 
Mobilier encastre 




</cuisine> 






<WC> 






Lavabo. Cumulus 200L. 




</WC> 






<sejour surfac 


5='40m2'> 




Cheminee e 


pierre. Poutres a 


plafond. 


Carrelage 


terre cuite. Grande 


baie vitree 


</sejour> 






<bureau surfac 


2='15m2'> 




Bibliotheq 


je encastree. 




</bureau> 






<garage/> 






</RDC> 






<etage> 






<terrasse> 






Palmier en 


zinc figurant le desert 


</terrasse> 






<chambre surfa 


:e='28m2' fenetre=' 


'> 


Carrelage 


terre cuite poncee. 




<alcove su 


-face='8m2' fenetre 


= '!'> 


Lambri 






</alcove> 






</chambre> 






<chambre surfa 


:e='18m2'> 




Lambri s. 






</chambre> 






<salleDeBains 


urface='15m2'> 




Douche, ba 


gnoire, lavabo. 




</salleDeBains 






</etage> 






</maison> 







Note 

Sur la figure 2-9, les espaces blancs ne sont pas mis en evidence, et les nceuds texte ne contenant que des 
espaces blancs ne sont pas montres, afin de ne pas trop compliquer la figure. Ces nceuds « a blanc » sont 
en general inutilises et souvent inoffensifs ; en deuxieme lecture, on pourra se reporter a instruction 
<xsi :strip-space> pour une analyse de ce probleme. 
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XPath, un langage d'expressions 

Note 

Cette section peut etre ignoree en premiere lecture 

Xpath est un langage d'expressions. Cela signifie que dans ce langage, a part I 'expres- 
sion, il n'existe aucune autre construction syntaxique. Sans etre complique, le langage 
n'est pourtant pas d'une simplicite extreme, etil peutarriver, de temps a autre, quel'on 
soit deroute par une subtil ite inattendue. 

En X Path, on peut manipuler quatre types d'objets : les ensembles de nceuds (type node- 
set, c'est-a-dire une collection nonordonnee sans repetition denceudsd'arbreX ML), les 
booleens (type boolean), les nombres reels (type number), les chaines de caracteres (type 
string). Les types booi ean, number et stri ng sont ce qu'on appelle des types simples. 

Par ailleurs, on dispose d'operateurs, mais il n'y a pas plethore : dans le genre minima- 
liste, c'estassez reussi. 

Enfin, on dispose de fonctions predefines, qui renvoient des valeurs de I'un des quatre 
types possibles, de variables, qui apparaissent sous la forme d'un nom precede d'un dol- 
lar (ex : $prixAuKilo), et de Valeurs litteraleS (ex : true, 12, 12.5, 'Bonjour Madame. 

eta-t-11 son chapeau.'). II n'y a pas de valeurs litterales de type node-set. 

Avec tout cela, on peut former des expressions. M ais il n'est pas tres simple d'etudier 
comment, parce qu'il n'est pas evident de trouver par quel bout prendre la chose ; une 
lecture fidele du standard X Path aurait vite fait de nous entrainer dans des contrees etran- 
gesou I'on definitdeschosesaussi incroyablesqu'un test d'inferiorite entre un node-set 
etun booleen. 

Note 

II ne faudrait pas croire pour autant que le standard XPath est un document loufoque : si ces comparaisons 
extraordinaires sont possibles, c'est parce qu'il existe des fonctions de conversions et des algorithmes d'interpre- 
tation des expressions mixtes, et que ces fonctions et algorithmes couvrent tous les cas utiles ; et de fait, dans la 
pratique, il peut etre indispensable de pouvoir convertir un node-set en booleen. A partir de la, plus rien ne peut 
I'empecher de le comparer a un autre booleen, meme si ce n'est pas forcement tres utile. 

Pour eviterdetomber dans ce genre detrou noir, nous allonsfaire un peu de slalom dans 
la grammai re XPath : nous verrons d'abord des expressions ne comportant aucun argu- 
ment de type node-set, puis des expressions ne comportant que des arguments de type 
node-set, puis nous evoquerons les expressions mixtes, en evitant de nous perdre dans les 
details. En annexe, on trouvera la description des fonctions deconversions a uti User. 
Enfin, et c'est la qu'on voulait en venir, nous arriverons au type principal d'expression 
XPath, lechemin de localisation, qui nousoccuperajusqu'alafin dece chapitre. 
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Note 

En premiere lecture, il n'est pas utile de suivre lineairement les prochaines sections. Vous pouvez sauter directe- 
ment a la section Expressions mixtes, page 45, dans lequel vous pourrez vous contenter de lire ce qui concerne 
la comparaison d'un node-set et d'un booleen, ainsi que celle d'un node-set et d'une string. Ensuite, vous pour- 
rez reprendre une lecture normale a partir de la section Principes de la construction d'un chemin de localisation, 
page 47. 

Les sections sautees pourront etre consultees ulterieurement, en cas de besoin, ou a titre de curiosite, pour 
completer vos idees et vos connaissances sur les expressions XPath. 

Expressions sans argument de type node-set 
Expressions numeriques 

Ce sont des expressions qui manipulent des nombres, c'est-a-dire des objets de type 
number. Ces nombres sont des nombres fractionnaires en double precision, conformes 
a la norme IEEE 754. Cette norme definit entre autres une valeur NaN (Not a Number) 
que I'on obtient par exemple dans la division de par 0, mais aussi un infini positif 

(infinity) et Un infini negatif (-Infinity). 

Les nombres peuvent etre compares par les operateurs = <= >= != qui ontleur significa- 
tion habituelle. 

Pour les calculs, on dispose de I'operateur « moins» unaire (-5.8, par exemple) et des 
cinq operateurs binai res classiques : + - * div mod (addition, soustraction, multiplica- 
tion, division, reste de la division entiere). Ajoutons a cela trois (excusez du peu) func- 
tions mathematiques predefines: floor (plus grand entier inferieur), ceiling (plus petit 
entier superieur) et round (plus proche entier). 

II n'y ariend'autre, memepasdefonction puissance ou racinecarree. 

Exemple d'expressions numeriques 

$b * 100 + $d - 4800 + floor($m div 10) 



Expressions a base de chaines de caracteres 

Les valeurs litterales de chaines de caracteres sont des sequences de caracteres entre 
apostrophes doubles ( -) ou entre apostrophes simples ( ■ ), comme on veut. 

On peut tester I 'egalitede deux chaines (operateurs = ou !=) mais on ne peut pas les clas- 
ser : les operateurs < ou > provoquent une conversion deleurs arguments en nombres. La 
seule maniere, a la rigueur envisageable, de classer deux chaines dans I'ordre alphanu- 
merique, seraitd'utiliser instruction detri proprea XSLT. 

On dispose de quelques fonctions predefines de traitement de chaines : 

• string-i ength, pour renvoyer le nombre de caracteres de la chaine ; 

• concat, pour concatener deux chaines en une seule (c'est-a-dire les mettre bout a bout) ; 
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• normal ize-space, pour supprimer tous les espaces blancs en tete, tous les espaces 
blancs en fin, et remplacer toute autre sequence interne d'espaces blancs par un seul 
espace ; 

• transi ate, pour remplacer certains caracteres par d'autres ; 

• substring, pour extrai re une sous-chaine ; 

• contains, pour tester la presence d'une sous-chaine dans une chaine ; 

• starts-wi th, pour tester la presence d'une sous-chaine au debut d'une chaine ; 

• substring-after, pour rechercher une sous-chaine et extraire la sous-chaine situee 
apres ; 

• substring-before, pour rechercher une sous-chaine et extraire la sous-chaine situee 
avant. 

Lafonction ends-with n'existepas. 

Expressions booleennes 

II n'y a pasdevaleurs litterales commetrue ou false pour representer les deux booleens 
possibles. Ces deux valeurs sont donnees par deux fonctions sans argument : true( ) et 

falseO. 

Pour operer des calculs booleens, on ne dispose que de deux operateurs, or et and, et 
d'une fonction predefine, noto, qui renvoie la negation deson argument. 

Exemple d' expression booleenne 

($somme < 3000) and (Sdevise = 'Franc') and ($fini or not( $trouve)) 

Les operateurs decomparai son < ><=>== i= sont utilisables avec les booleens. Les 
operateurs = et != ont le sens habituel ; les operateurs d'inegalite provoquent une 
conversion prealable des booleens en nombres, avec la convention true donne 1 et false 
donne ; ensuite on compare les nombres. N otez que si $a et $b sont deux booleens, $a 
<= $bsignifie"$a impiique $b" (en effet, "$a impiique $b" n'estfaux quesi $a est vrai 
et $b est faux, cequi est compatible avec unecomparaison des nombres et 1, d'apresla 
convention indiquee). 

Expressions avec arguments de type node-set 

Un node-set, nous I'avons deja dit, est un ensemble de nceuds provenant d'une source 
XML, etplus precisementdela representation sous forme d'arbreXM L de cette source. 
Qu'un element appartienne a un node-set n'implique pas que sa descendance en fasse 
necessairement partie: par exemple, on peut tres bien avoir un node-set ne contenant 
qu'un seul element, a savoir I'element racine du document, sans que pour autant, tout le 
document se retrouve dans le node-set. 

Un node-set est un ensemble au sens mathematique du terme: une collection non 
ordonnee de nceuds d'arbreXM L, sansdoublon. 
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II n'y a qu'un seul operateur ensembliste : I'operateur ■ | " (la barre vertical e), qui repre- 
sentel'union ensembliste. II esttoutefois possible d'ecrireune expression, pastrescom- 
pliquee en termes de nombre de caracteres, mais tres difficile a imaginer quand on ne 
connaitpas la solution, qui donne I 'intersection dedeux node-sets. 

Note 

C'est d'ailleurs si peu evident a trouver que les concepteurs du standard XPath etaient loin d'imaginer que 
c'etait faisable lorsque le standard est paru dans sa version definitive, en 1 999. En fait, il a fallu attendre I'annee 
2000 pour que quelqu'un (Michael Kay, en I'occurrence) decouvre cette fameuse expression, que voici : 
$p[count (. |$q) = count($q)], qui donne I'intersection des deux node-sets $p et $q. II n'est pas possible 
d'expliquer des maintenant pourquoi le resultat obtenu est le bon, car il faut attendre d'avoir vu la notion de predi- 
cat, qui est ici utilisee, ainsi que celle de noeud contexte (le point, juste avant la barre verticale). 

II n'y apasnon plusd'operateurou defonction predefine permettantde tester I' apparte- 
nance d'un noeud a un node-set (sinon il aurait ete trivial de construire une expression 
donnant I'intersection), ou I'inclusion d'un node-set dans un autre. Par contre, on a une 
fonction predefine, count o, qui renvoiele nombre d'elementsdu node-set donne, ce qui 
permet (entre autres) de tester si un node-set est vide. 

Les choses amusantes arrivent maintenant. II est possible, grace aux operateurs = et i=, 
de comparer des node-sets. Les regies de comparaison sont a premiere vue assez cu- 
rieuses, et en tout cas, ont des consequences assez etonnantes, comme par exemple cell e- 
ci : si $p est un node-set, alors$p = $p n'est pas une expression toujoursvraie. 

Remarque 

Avant de voir ceci plus en detail, demandons-nous pourquoi aller chercher des regies diaboliques qui parsement 
la route de chausse-trappes, au lieu de mettre en place de regies classiques qui seraient intuitivement evi- 
dentes ? A nouveau, il ne faut pas imaginer que le standard XPath est un document loufoque, pratiquant 
I'humour par I'absurde. En fait ces regies sont bizarres quand on les examine en dehors de leur contexte, et 
qu'on les replace dans le contexte general (mathematique) de manipulation d'ensembles. Mais ce n'est pas 
dans ce contexte-la que ces expressions sont employees ; ces regies sont faites pour ecrire des predicats de 
fagon concise. II est encore trap tot pour expliquer exactement ce qu'est un predicat, mais disons en gros qu'un 
predicat est une expression booleenne qui permet de filtrer un node-set pour eliminer les indesirables, a savoir 
les noeuds qui ne verifient pas le predicat. C'est done a la lumiere de la facilite d'ecriture de predicats qu'il faut 
eclairer les regies de comparaison de node-set, et non a la lumiere des mathematiques standard. En cherchant 
a optimiser au mieux I'ecriture de certains types de predicats qui reviennent souvent dans la pratique, on arrive 
a des choses qui peuvent donner froid dans le dos au premier abord, mais qui finalement se revelent tres effi- 
caces a I'usage, quand on ecrit des predicats. Le seul probleme est que les comparaisons de node-sets peuvent 
intervenir ailleurs que dans des predicats, par exemple dans des tests, avec I'instruction XSLT <xsi :if . . .>. 
C'est la qu'on peut deraper, parce qu'on n'est plus dans le domaine privilegie des predicats, et que I'on doit etre 
conscient des pieges que constituent ces regies vis-a-vis de la logique habituelle. 

Comparaison de deux node-sets avec I'operateur = 

Si $p et $q sont deux node-sets, alors $p = $q est une expression booleenne vraie si et 
seulement si on peut trouver dans $p un noeud ni et dans $q un noeud N2 qui ont meme 
valeur textuelle. 



Le langage XPath 

Chapitre 2 

Cette definition repose sur la valeur textuelle d'un nceud, qui a ete definie a la section 
M odele arborescent d 'un document XML vu par XPath, page 30. 

On voit tout de suite qu'i I fautpouvoirtrouverau moinsun nceud dans chacundes node- 
sets pour que I'egalite ait une chance d'etre vraie ; il en resulte immediatement que deux 
node-sets videsne sont pas egaux, et meme pi re, que $p = $p estfaux si $pestvide. 
U n autre point a prendre en compte, est que la valeur textuelle d'un nceud ne reflete peut- 
etre pas total ement toutes les proprietes visibles de ce nceud. 

Par exemple, SUppOSOnS que $p COntienne I 'element <animal hauteur=' , 3m">gi rafe</ani - 
mal>, et $q I'element <animal hauteur="5m">gi rafe</animal> ; alors I'egalite $p = $q 

est vraie. En effet, lesattributs ne font pas partiede la valeur textuelle d'un element: les 
deux elements ci-dessusont done meme valeur textuelle, cequi suffit a donner I'egalite. 

Comparaison de deux node-sets avec I'operateur != 

Si $p et $q sont deux node-sets, alors $p != $q est une expression booleenne vraie si et 
seulement si on peut trouver dans $p un nceud ni et dans $q un nceud N2 qui ont des 
valeurs textuelles differentes. 

D'apres les deux definitions que I'on vientdevoir, il estimmediatque: note $p = $q ) 
et ( $p i= $q ) sont deux expressions differentes, qui ne donnent pas en general le 
meme resultat. II en est de meme avec note $p != $q ) et ( $p = $q ). 

L'expression note $p = $q ) est vraie quand les deux node-sets ont des valeurs tex- 
tuelles toutes differentes deux a deux. De meme, I'expression note $p != $q )estvraie 
quand les deux node-sets ont des valeurs textuelles toutes identiques deux a deux. 

Notez bien encore une fois que les comparaisons reposent sur des comparaisons de 
valeurs textuelles; il n'est pas question ici d'identite : revoyez ci-dessusl'exempledela 
girafe, qui montrebien les limitesdeces comparaisons. 

Appartenance et test d'inclusion 

Tester si deux node-sets sont constitues des memes nceuds est beaucoup plus subtil ; e'est 
le meme probleme, en gros, que de tester si un nceud donne appartient ou non a un node- 
set. Pour cela I 'idee de base est d'ajouter au node-set le nceud en question ; si cela ne 
change pas le cardinal du node-set, e'est que le nceud s'y trouvait deja (puisqu'un node- 
set est un ensemble, et qu'a ce titre, il ne sauraity avoir des doublons). II faut done se 
debroui Her pour former un node-set (disons $p) ne contenant que le nceud a tester; 
pour savoir si ce nceud appartient a un autre node-set $q, il suffit de tester I'expression 

count( $p I $q ) = coimt( $q ). 

Note 

C'est cette idee qui a mis du temps a voir le jour. 

Detail amusant, on peut voir a I'adresse http://dpawson.co.uk/xsl/sect2/muench.html, que Michael Kay en a eu 

la revelation dans son bain. 
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Plus general ement, I'expression countc $p | $q ) = countc $q ) est vraie si etseu le- 
nient si le node-set $p est inclus dans $q. 

Dans la meme veine, on voit immediatement que les deux node-sets $p et $q sont iden- 
tiques (egaux au sens mathematique du terme) si et seul ement si : 

(count( $p | $q ) = count( $q )) and (countt $p | $q ) = count( $p )) 

Expressions mixtes 

Les expressions mixtes sont celles ou un argument est un node-set, et I'autre un type 
simple (Boolean, String, Number). 

• node-set = Boolean ou node-set i = Boolean 

Le node-set est converti en booleen comme par appel de la fonction predefinie 
booieano, qui renvoievrai si etseulementsi le node-set donne n'est pas vide. On n'a 
alors plus qu'a comparer deux booleens. 

• node-set = String ou node-set ! = String 

L'egalite (respect, inegalite) est vraie si etseulementsi I e node-set contientau moins 
un nceud dont la valeur textuelle est egale a (respect, differente de) la String donnee. 

• node-set- Number ou node-set !- Number 

L'egalite (respect, inegalite) est vraie si etseulementsi le node-set contientau moins 
un nceud dont la valeur textuelle, convertieen nombre, est egale au (respect, differente 
du) Number donne. 

• node-set < > <= >= Boolean 

Le node-set est converti en booleen comme par appel de la fonction predefinie 
booieano, qui renvoievrai si etseulementsi le node-set donne n'est pas vide. On n'a 
alors plus qu'a comparer deux booleens. 

• node-set < > <= >= Number 

Lacomparaisonestvraiesi etseulementsi le node-set contientau moins un nceud dont 
I a valeur textuel I epeutetre convertieen un nombre pour I equel lacomparaisonavec le 
Number donne est vraie. 

• node-set < > <= >= String 

Lacomparaisonestvraiesi etseulementsi le node-set contientau moins un nceud dont 
I a valeur textuel I epeutetre convertieen un nombre pour I equel lacomparaisonavec la 
String donnee, converti eel I eaussi avec succesen nombre, est vraie. Danstouslescas, 
si jamais la String donnee ne peut pas etre correctement converti e en nombre, la 
comparaison estfausse. 

C'est ici que nous trouvons ces fameuses expressions bizarres, qui consistent (par ex- 
emple) a tester la relation d'inferioriteou desuperiorite entreun node-set etun booleen. 
Comme nous I'avons dit, la motivation essenti el I e de ce genre de conversion est de 
pouvoir ecrire de facon concise certains predicats frequents dans la pratique. 
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II n'est pas possible de montrer cela dans le detail des maintenant, mais on peuttout de 
memedonner une idee de la chose. Imaginons par exemple un document X M L formant 
un recueil de descriptions de maisons comme eel le que nous avons vue a la section 
Exemple d'arbre XML d'un document, page 38. Supposons de plus que nous ayons 
forme un node-set $ies-rdc qui contienttous les <rdc> detoutes les<maison>. 

On peutalorsfiltrer le node-set $ies-rdc par le predicat [ garage ] , comme ceci : 

$les-rdc[ garage ] 

Celadonneun nouveau node-set qui necomportequedesrez-de-chausseeavec au moins 
un garage. Mais si cela donnecela, e'est parcequ'arrive a unecertaineetapede I 'inter- 
pretation de cette expression, I 'interpreter XPath reclame une expression booleenne 
applicable a chaque element <rdc> candidat a f aire partiedu nouveau node-set; si cette 
expression booleenne est vraie, le candidat est accepte, sinon il estrejete. Or, acestade, 
il setrouve que I 'expression garage est interpret.ee comme une valeur de type node-set : 
e'est la qu'intervient cette fameuse conversion de node-set en booleen, grace a laquelle 
I 'interpreteur XPath va obtenir I 'expression booleenne qu'il attend. 

M ais voici quelqu'un qui voudrait voir toutes les maisons qui ont une terrasse en etage 
avec un palmier en zinc figurant I e desert. Rien de plus facile: 

$les-etages[ terrasse = "Palmier en zinc figurant le desert" ] 

La encore, si cela fonctionne, e'est parcequ'au moment ou I 'interpreteur XPath reclame 

SOn expression booleenne, On lui fOUmit terrasse = "Palmier en zinc figurant le 

desert". D'apres ce que nous avonsvu, cette expression estvraie s'il I'onpeuttrouverau 

moins Une <terrasse> dont la Valeur textuelle est egale a "Palmier en zinc figurant 
le desert". 

C 'est done pour opti miser la faci I ite d'ecriture detels predicats que ces regies bizarresde 
conversi on etdecomparai son ont eternises en place. C'estvrai quel'on obtient alorsdes 
predicats assez concis, et qui se lisent assez bien ; mais des que Ton quitte le domaine 
des predicats, le cote bizarre de ces comparaisons reprend alors le dessus. 
II fautassumer. 

Conclusion 

Nous arrivons maintenant aux portes du temple XPath. Comme nous I'avons deja dit, 
XPath est essentiellement un langage d'expressions pour construire des node-sets 
contenant des nceuds preleves dans I'arbre XML document source : de telles expressions 
s'appellent des chemins de localisation (location path), et ce sont elles que nous allons 
maintenant etudier. 
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Principes de la construction d'un chemin de localisation 



Note 

A lire des la premiere lecture. 



Nceud contexte 

Etant donne un certain nceud (appele n«ud contexte) de I'arbre XML d'un document 
source, un location path (ou chemin de localisation) permet de designer ses voisins plus 
ou moins proches ou lointains, dans toutes les directions (ascendants, descendants, 
freres, cousins, etc.). 

Le nceud contexte, en tant que point de depart de la navigation dans I'arbre XML d'un 
document, est une des notions fondamentales du langage X Path, que I 'on retrouvera sans 
cesse dans la suite. 

Chemin de localisation 

U n chemin de localisation a la forme suivante(exprimee en uti I isant la notation des DTD) : 

Location Path 

LocationPath = "/"?, LocationStep, ( "/", LocationStep )* 

Un chemin de localisation est done une suite d 'eta pes de localisation (location step) 
separees par des v. Le ■/" initial indique un chemin absolu ; en son absence, on a un 
chemin relatif. 

Le nceud contexte est indispensable pour I 'evaluation d'un chemin de localisation rela- 
tif ; pourun chemin absolu, le point de depart est la racinede I'arbre XML du document 
(en cesens, on peutdirequ'un « chemin absolu » est relatif a la racine, alors qu'un « che- 
min relatif » est relatif au nceud contexte). 

Evaluation d'un chemin de localisation 

Lorsqu'onevalueun chemin de localisation, on obtientun node-set, e'est-a-dire une col- 
lection de nceuds non ordonnee et sans repetition. On dit que le chemin de localisation 
selectionneun ensemble de nceuds. Ce processus de production d'un ensemble de nceuds 
repose sur la repetition d'etapes de localisation, chacunedecesetapesconsistantessen- 
tiellement en un processus d'elimination : on part d'un ensemble initial de nceuds, que 
I 'on passe au cribleuneou plusieurs fois (souvent uneseulefois), avec des cribles diffe- 
rents. 

Ce qui reste apres application de cette succession d'etapes, est I 'ensemble de nceuds 
selectionne par le chemin de localisation. 

II fautmaintenantvoirchacun des constituants d'une etape de localisation. 
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Etape de localisation 



Note 

A lire des la premiere lecture. 

Une etape de localisation a la forme suivante (notation DTD) : 

LocationStep 

LocationStep = Axis, "::", NodeTest, Predicate* 

Chaque etape de localisation se compose done : 

• D'un axe de localisation, qui produit I 'ensemble initial de nceuds (a condition de 
connaitre le noeud contexte). L e mot axe vient de ce que cet ensemble initial est consti- 
tue a partir de nceuds choisis selon un critere evoquant une direction ou un axe de 
deplacement dans I 'arbre (parents, enfants, freres, etc.). 

• D'un premier cri ble (NodeTest, ou determinant) permettantd'eli miner del 'ensemble 
initial de nceuds tous ceux qui ne repondent pas au critere indique par le NodeTest 
(qui porte sur la nature des nceuds a conserver). Ce premier crible permet par exemple 
dedirequ'on neveutgarderqueles<piedDePage>, ou queles<figure>, etc. 

• Eventuellement de cribles supplemental res, appeles predicats, permettant de dire par 
exemple qu'on ne veut pas garder toutes les <figure>, mais seulement celles qui ont 
un attri but 'type' egal a 'gif'. 

Exemple: 

LocationStep 

child: :figu re [attribute: :type='gif ' ] 

Cette etape de localisation se decompose ainsi : 

• child est I ' axe de localisation ; il fournit I 'ensemble de depart, constitue ici de tousles 
nceuds enfants directs du noeud contexte. 

• figure est le determinant (N odeTest) ; il permetd'eliminerdecetensemblede depart 
tous les nceuds qui ne sont pas des <f 1 gure> . 

• [attribute: :type='gif ] est le premier (et I'unique) predicat, qui joue le role de 
deuxieme crible, eliminant tous les nceuds <figure> n'ayant pas un attri but type egal 

a gif. 

Le principe de construction d'un node-set par une etape de localisation est done assez 
simple : on part d'un node-set initial fourni par un axe de localisation, qui est d'abord 
filtre par un determinant, puis par des predicats. 
Nous allons done voir maintenant plus en detail chacun de ces constituants. 
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Axes de localisation 



Mentionner un axe de localisation dans une etape de localisation permet d'obtenir un 
node-set initial, qui sera ensuite progressivement elague sous I'action du determinant 
(Node Test) puis despredi cats. 

L'idee est done qu'un axe de localisation represente une premiere approximation de ce 
quel'on veut, en sebasantsur la notion devoisinagedu nceud contexte: les enfants, les 
freres, les ascendants, etc. : on choisit ce qui se rapproche le plus du node-set souhaite, 
quitte ensuite a filtrer les nceuds en trap. L'approximation doittoujours sefaire par exces, 
puisqu'il est possible de filtrer, mais pasd'ajouter. 

Etant donne un nceud-contexte, un axe est done un ensemble de nceuds, partageant une 
propriety commune vis-a-vis du nceud contexte. 

Les treize axes de localisation 

Le standard X Path definit treize axes de localisation. Les onze premiers sont construits a 
parti r du nceud contexte sur la base de la relation parent-enfant, ce qui donne un arbre 
genealogique presqueidentiquea I'arbreXML du document source : il ne manque que 
les nceuds detype attribute et namespace. Precisement, les deux derniers axes corres- 
pondent aux attributs et domaines nominaux du nceud contexte, mais ils sont un peu a 
part, puisqu'il n'y a pas de relation parent-enfant complete entreun nceud et ses attributs 
ou domaines nominaux (revoir a ce sujet les sections Na?ud de type attribute, page 33 et 
Nceud de type namespace, page 34). 

Voici la liste de ces 13 axes: 

• child 

contient les nceuds enfants (directs) du nceud contexte. Necontientjamaisde nceud de 
type attri but ou domai ne nomi nal . 

• descendant 

contient toute la descendance (enfants, petits-enfants, ...) du nceud contexte. Ne 
contient jamais de nceud detype attri but ou domaine nominal. 

• parent 

contient le parent du nceud contexte. Existe pour tout nceud contexte (meme de type 

attribute OU namespace), Sauf pour la racine (root). 

• ancestor 

contient les ascendants (parent, grand-parent, ...) du noeud contexte. Contient touj ours 
la racine (meme si le nceud contexte est de type attribute ou namespace), sauf si le 
nceud contexte est la racine. 

• self 

contient le nceud contexte et seulement le nceud contexte. 

• following-sibling 

contient les freres suivants (dans I 'ordre de lecture du document) du nceud contexte. 
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Si lenceudcontexteestun noeudde type attri but oudomaine nominal, I 'axe foil owing- 
sibling est vide. 

• preceding-sibling 

contient lesfreres precedents (dans I 'ordrede lecture du document) du nceud contexte. 
Si le nceud contexte est un nceud de type attribut ou domaine nominal, I'axe 

preceding-sibling estvide. 

• following 

contient tous les nceudsqui suiventlenceud contexte dans I'ordrede lecture du docu- 
ment, en excluant d'une part la propre descendance du nceud contexte, et d'autre part 
les nceuds de type attribut ou domaine nominal. 

• preceding 

contient tous les nceuds qui precedent I e nceud contexte dans I'ordredu document, en 
excluant d'une part la propre ascendance du nceud contexte, et d'autre part les nceuds 
de type attri but ou domai ne nomi nal . 

• descendant-or-self 

contient I e nceud contexte et tous ses descendants (comme son nom I'indique). 

• ancestor-or-self 

contient le nceud contexte et tous ses ascendants (comme son nom I'indique). En 
consequence, contient touj ours la racine. 

• attribute 

contient les attri buts du nceud contexte si le nceud contexte est un element ; est vide 
danslecascontraire. 

• namespace 

conti ent I es domai nes nomi naux du nceud contexte si I e nceud contexte est un element ; 
est vide dans le cas contraire. 

Representation graphique 

On peut representer graphiquement (voir figure 2-10) les ensembles de nceuds que 
forment les axes (les axes attri bute et namespace ne sont pas montres, et I 'un des nceuds 
element est pris arbitral rement comme nceud contexte). 

Note 

La figure 2-10 est tres largement inspiree d'un schema extrait de « Practical Transformation Using XSLT and 
XPath », un support de cours et un livre sans nom d'auteur (copyright 1998-2001 Crane Softwrights Ltd.) dont un 
extrait est disponible sur www.cranesoftwrights.com/training/. 

On voitsur la figure 2-10 que I'axe child d'un element peut contenir des nceuds de type 

element, ITiaiSaUSSi de type processing instruction, text, OU comment. A fin depOUVOir 

trier, on dispose depossibi I ites detests adequats (voir Determinant (Node Test), page 54). 
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Figure 2-10 

Representation des axes de localisation en tant qu 'ensembles. 



D 'autre part, les numeros des nceuds sur cette figure correspondent a I'ordre d'apparition 
de leur balise ouvrante, lors de la lecture sequentielle du document X M L correspondant, 
qui ressembledoncaceci (le noeud 9 est le noeud contexte) : 



<3/> 

<4/> 
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<? processing-instructioi 
<10> 

<ll/> 

<12/> 
</10> 

<!-- commentaire --> 
<13> 

<14/> 

<15/> 
<13/> 
un texte 
</9> 
<16/> 
<17> 

<18/> 



</5> 
<19/> 

<20/> 



Remarque 

Sur la figure 2-10, on voit le node-set sei f , qui ne comporte qu'un seul element. Pourtant, cet element possede 
une descendance assez nombreuse : il est important de realiser qu'un node-set peut tres bien contenir un 
element sans pour autant contenir les enfants ou la descendance de cet element. Mais ce n'est pas interdit non 
plus : voir par exemple le node-set descendant-or-sei f . 

LeS axes parent, ancestor, ancestor-or-sel f, preceding, et preceding-sibling ne 

contiennent que des nceuds situes avant (par rapport au nceud contexte) dans I'ordre de 
lecture du document : on les nomme axes retrogrades. 

Tous les autres axes (y compris les axes attri bute et namespace) ne contiennent que des 
nceuds situesapres (par rapport au nceud contexte) dans I'ordre de lecture du document: 
on les nomme axes directs. 

L'ordre de lecture du document, pour les attri buts et les domaines nominaux, est un peu 
arbitraire par certains cotes. La regie est celle-ci : les attri buts et domaines nominaux 
viennent apres leur element parent, et avant les enfants de ce parent (ce qui est somme 
toute parfaitement logique, et correspond effectivement a I'ordre de lecture du docu- 
ment). Cequi est arbitral re, c'est que les domaines nominaux viennent avant les attri buts 
(c'est une simple convention). M ais aucun ordre de lecture de document n'est defini pour 
classer les attri buts entre eux, ni les domaines nominaux entre eux, car I'ordre dans 
lequel ils apparaissent n'est pas cense etre signifiant (cette propriete est imposee par 
XML). 
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Indices de proximite 

On definit aussi une numerotation des noeuds relative a un axe, dont les numeros, appeles 

indices de proximite, commencenttoujoursa 1. 

Pour un axe direct (par. ex. child ), les indices de proximite augmentent quand on s'e- 

loigne du nceud contexte en suivant I 'ordre de lecture du document, alors que pour un axe 

retrograde (par. ex. preceding-sibling ), les indices de proximite augmentent quand on 

s'eloigne du nceud contexte dans I 'ordre inverse de lecture du document. 

A titre d'exemple, reprenons la figure 2-10 , et montrons les indices de proximites pour 

deUX axes retrogrades (preceding, ancestor-or-self), et pour 2 axes directs (descen- 
dant, following). Ces indices de proximite sont montres sur la figure 2-11 (les anciens 
numeros sont rappeles en plus petit, a I'exterieur de chaque cercle). 



ancestor-or-self 
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Figure 2-11 

Indices de proximite. 



La regie, pour un node-set intervenant dans une etape de localisation, est que les indices 
de proximite donnent I 'ordre d'enumeration. 
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Remarque 

Ces indices de proximite servent (entre autres) a fournir, quand besoin est, un ordre d'enumeration. Un node-set, 
rappelons-le, est un ensemble, et a ce titre, n'est pas ordonne. Pas ordonne, cela signifie que I'ordre d'enumera- 
tion des elements n'est pas une propriete discriminante lorsqu'on cherche a distinguer deux ensembles : les 
ensembles {x,y} et {y,x} sont indiscernables. 

Ceci etant, lorsqu'on enumere un node-set, par exemple pour traiter chacun de ses elements un par un, il taut 
bien choisir un premier, un deuxieme, etc. jusqu'a un dernier. Done meme si un node-set n'est pas ordonne, il est 
certainement utile, dans la pratique, d'avoir a sa disposition un algorithme d'enumeration. 

Determinant (Node Test) 

Etant donne un ensemble de nceuds fourni par un axe de localisation, le determinant est 
unefonction booleenne, qui, appliqueeaun nceud decet ensemble, ditsi cenceud doitou 
non rester dans I 'ensemble. 

L'ecriture : 

Axis: :NodeTest 

denote I 'ensemble obtenu en appli quant le determinant NodeTest a chaque element de 
I'axeAxis. 

II y a plusieurs possibility pour un NodeTest: pourchacuned'elle, on doit specifier la 
fonction booleenne, e'est-a-dire expliquer le critere mis en ceuvre pour accepter ou reje- 
ter un noeud. Pour cela, il est necessaire d'introduire une nouvelle notion, celle de type 
principal de na?ud. 

Le type principal de noeud d'un axede localisation, e'est le type de nceuds les plusfre- 
quemment contenus dans cet axe. 

• L'axe attribute ne contient que des nceuds detype attribute, son type principal de 

nceud est done attribute. 

• L'axe namespace ne contient que des nceuds de type namespace, son type principal de 

nceud est done namespace. 

• Les onze autres axes peuventcontenir aussi bien des nceuds de type element, quede 

type comment, OU processing-instruction, OU root, OU text. NeanmoinS, le plUSfre- 

quent, et de loin, est qu'ils contiennent des elements. Le type principal de nceud est 

done element. 

Ceci etant, nous allons pouvoir maintenant passer en revue les differentes formes pos- 
sibles pour un determinant (Node Test). 

Le determinant est un nom 

Node Test = nom 

Axis::nom 
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Le determinant est ici un nom (d'element, d'attribut, ...). Applique a un nceud del 'axe de 
localisation indique, I e determinant acceptece nceud si le type du nceud est egal au type 
principal de nceud del'axechoisi, etsi lenom du nceud coincide avec lenom constituant 
I e determinant; danslesautrescas, le nceud estrejete, etdonc ne fait pas partiedu node- 
set resultant. 

Exemple: 

child: :figure 

Etantdonne un certain nceud contexte, cette etape de localisation selectionneun node-set 
contenant tous les elements de I'arbre XML considers, qui sont des enfants du noeud 
contexte, etdont lenom est figure. Tous lesautres nceuds sont rejetes : 

• soit a cause de leur type qui n'est pas egal au type principal de nceud (ei ement pour 
I 'axe chi id) ; 

• soit a cause de leur nom qui n'est pas egal a figure. 

La premiere cause de rejet (portant sur le type) permet d'eliminer par exemple une 
processing-instruction qui par malchance se denommerait elle aussi figure. 

Le determinant est une * 



Axis::* 

Une* est un determinant qui nefiltre que le type de nceud : sont rejetes tous les nceuds 
dont le type ne correspond pas au type de nceud principal associe a I 'axe indique. 

Exemple: 



Etantdonne un certain nceud contexte, cette etape de localisation selectionneun node-set 
contenant tous les nceuds de type ei ement, enfants du nceud contexte. 

Autre exemple : 



Etantdonne un certain nceud contexte, cette etape de localisation selectionneun node-set 
contenant tous les nceuds de type attn" bute, qui ont pour parent le nceud contexte, c'est- 
a-dire, pour parler plus si mpl ement, tous les attributs du nceud contexte. 

Le determinant est un descripteur de type 

C e genre de determinant teste I etypede nceud aselectionner. En cesens, la selection est 
plus fine que dans lecas precedent, avec I'etoile. Uneetoile teste aussi le type de nceud a 
selectionner, mais le type est impose par I'axe mentionne (c'est le type principal de 
noeud). Ici, le type est a choisir parmi quatre valeurs possibles, et le type principal 
de nceud associe a I'axe de localisation mentionne n'intervientpas. 
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Node Test = type 



Les quatre valeurs de types possibles (avec une variante) sont les suivantes : 

• text() 

text( ) est un determinant qui selectionne tout nceud de type text, et rejette tous les 
autres. 

• commentO 

commento est un determinant qui selectionne tout nceud de type comment, et rejette 
tous les autres. 

• processing-instructionO 

processing-instructiono est un determinant qui selectionne tout noeud de type 
processing-instruction, et rejette tous I es autres. 

• processing-instruction( « xxx » ) 

processing-instruction( "xxx" ) est un determinant qui selectionne tout noeud de 
type processing-i nstruction dont le nom est xxx, et rejette tous les autres. 

• node() 

nodeo est un determinant qui ne rejette aucun noeud. Et comme le type principal de 
noeud n'intervientpas, (ni danscecas, ni dans les quatre autres ci-dessus), on a done le 
contenu del'axede localisation au grand complet. 

Exemples: 

child: :text() 

selectionne les noeuds de type text, enfants du noeud contexte. 

child::comment() 

selectionne les noeuds de type comment, enfants du noeud contexte. 

child: :processing-instruction() 

selectionne les noeuds de type processing-instruction, enfants du noeud contexte. 

child: :processing-instruction( "play" ) 

selectionne les noeuds de type processing-instruction, enfants du noeud contexte, et 
dont le nom est « play ». 

child: :node( ) 

selectionne tous les noeuds enfants du noeud contexte. On obtientdonc un node-set iden- 
tique a I'axe de localisation. C'est utile si on veut filtrer par d'autres criteres que ceux 
predefinis par les determinants possibles; dans ce cas, on ne filtre rien au niveau du 
determinant, maison exprimele filtre dans leou lespredicats. 
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Predicats 



U n predicat permet d'affiner le filtrage deja effectue par I e determinant sur I'axe de loca- 
lisation choisi, en el i mi nant del 'ensemble resultat I esnceuds qui ne repondent pas a un 
certain critere, dont I 'expression constitue precisement le predicat. 

II a la forme suivante : 

Predicat 

[ Boolean-Expression ] 

U n predicat s'applique a un ensemble de nceuds (node- set) et produit un nouveau node-set. 

Le node-set de depart peut avoir di verses origines : il peutetre le resultat du filtrage d'un 
axe de localisation par un determinant, ou encore le node-set produit par un autre predi- 
cat. 1 1 peut meme etre n'importe quel node-set reference par une variable, comme dans 
I'exemple : 

$les-etages[ terrasse = "Palmier en zinc figurant le desert" ] 

qui nous a servi a expliquer les raisons de certaines bizarreries (voir la fin de la section 
Expressions mixtes, page 45). 

Note 

Nous parlons ici a nouveau de variable ; il est vrai que nous n'avons pas encore vu la fagon de declarer et 
d'initialiser une variable ; cela viendra bien plus tard, a la section Instruction xstivariabie, page 179. En effet, 
XPath ne definit pas la notion de variable, mais uniquement celle de reference a une variable, avec la notation 
$xxx. La notion de declaration et d'initialisation de variable est une notion propre a XSLT. II est done impossible, 
a ce niveau, de montrer un exemple ou une telle variable serait initialisee. 

Comme le resultat du filtrage d'un node-set est a son tour un node-set, on peut(eventuel- 
lement) lui appliquer de nouveau un predicat, et ainsi de suite : 

Predicats en cascade 

Axis::NodeTest[Boolean-Expression][Boolean-Expression] .. . [Boolean-Expression] 

Contexte devaluation d'un predicat 

Le resultat de devaluation d'un predicat est un nouveau node-set, initialementvide, puis 
progressivement constitue en examinant un par un chaque nceud de I 'ensemble de depart, 
et en testant s'il doit ou non faire partie du node-set resultat. 
Ce node- set de depart (appelons-le N SD ) est necessairement un sous-ensemble d'un axe 
de localisation, qui lui-meme n'existe que par rapport a un nceud contexte. On est done 
ici dans une situation ou un nceud contexte NC est defini, et ou un axe de localisation a 
ete choisi, donnant I e node-set NSD (apres un eventuel filtrage par un determinant). 

L'expression booleenne entre crochets, qui constitue I e predicat, est evaluee pour chaque 
element du node-set NSD ; cette evaluation se fait relativement a un contexte, appele 
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contexte d 'evaluation, comportant trois informations, et construit dynamiquement pour 
chaque element du node-set NSD : 

• le nceud en cours d'examen, considere d'office comme nceud contexte temporaire, si 
jamais I 'expression booleenneaevalueren abesoin d'un ; 

• lenombre total denceuds del 'ensemble NSD (accessible par appel a la fonction prede- 
finieiasto) ; 

• et I'indice de proximite qui a ete affecte au nceud en cours d'examen, lors de la construc- 
tion du node-set NSD (accessible par appel a la fonction predefine positiono). 

Grace a ce contexte devaluation, tout predicat, aussi complexe soit-il, peutetreevalue. 
Envoici quelquesexemples: 

Predicat utilisant I'indice de proximite conserve dans le contexte d'evaluation 

child: :figure[ positionO = 3 ] 

Etantdonne un certain nceud contexte NC, child: : figure selectionne un node-set NSD 
contenanttous les elements de I 'arbreXM L considere, enfants de ce nceud contexte NC, 
etdontlenom est figure. A partir dela, le predicat est evalue : pour chaque element du 
node-setNSD, I'expression booleennepositiono = 3estevaluee. Lafonction predefi- 
nie positionO renvoie la valeur de I'indicede proximite du nceud en cours d'examen : si 
cette valeur est 3, le nceud est conserve dans le node-set resultat, sinon il est rejete. Au 
final, on obtient done un node-set d'au plus un element, qui est la troisieme <figure>, 
enfant du nceud contexte N C . 

Predicat utilisant le nombre total de nauds conserve dans le contexte d'evaluation 

child: :figure[ positionO = lastO ] 

lei, le node-set NSD estconstitue dela memefacon, mais le predicat est legerement dif- 
ferent : la fonction predefinie lasto renvoie le nombre total d'elements de NSD ; done 
leseul element qui ne sera pas rejete par le predicat sera I e dernier, puisque les indices de 
proximite commencenta la valeur 1. Au final, on obtient done un node-set d'au plus un 
element, qui estladerniere<figure>, enfant du nceud contexte NC. 

Predicat utilisant le naud contexte temporaire conserve dans le contexte 
d'evaluation 

child: :figure[ attribute: : type = 'gif ] 

lei, le node-set NSD estanouveau constitue dela memefacon, mais le predicat est com- 
pletement different. II sera analyse plus en detail un peu plus loin ; nous nous contente- 
rons pour I 'instant devoir comment intervientle nceud contexte temporaire. 
Pour chaque element du node-set NSD, il s'agit de comparer un node-set (le node-set 
attribute: :type) a unechaine de caracteres. La premiere chose a faire est done d'evaluer 
le node-set attribute: :type, fourni ici sous la forme d'uneetapede localisation, basee 
sur I'axede localisation attribute. Mais devaluation d'un axe de localisation reclame un 
nceud contexte: le contexte d'evaluation enfournitun, c'estle nceud en cours d'examen. 
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C haque nceud exami ne devi ent done tour a tour « noeud contexte temporal re » dans I 'eva- 
luation de I 'etape de localisation attribute: :type, qui selectionne tous les attributs du 
noeud contextetemporairedontlenom est "type". On obtientalorsun node-set d'au plus 
un noeud (qu'il s'agit ensuite de comparer a une String : voir Predicat sous la forme 
[node-set], page 59). A u final, onobtientun node-set constituedetoutes les <figure> qui 
sont des enfants du noeud contexteNC, etqui ontun attribut "type" egal a "gif". 

Conversion booleenne de node-set 

Nous avons deja assez longuementevoque dans la section Expressions avec arguments 
de type node-set, page 42 les expressions mettant en jeu des node-sets pour obtenir un 
booleen. M ais il n'est peut-etre pas inutile d'y revenir, en se placant ici dans le contexte 
precis de devaluation d'un predicat. 

II peut arriver que, dans un predicat, I'expression entre crochets [. ..] ne soit pas une 
expression booleenne. Danscecas, ell e est convertie en expression booleenne, suivantun 
algorithmequi depend dela nature de I'expression, etqui peut paraitre, on I'a vu, un peu 
surprenant. Dans la pratique, deux cas se produisent assez souvent : I'expression entre 
crochets est un node-set, ou bien est la comparaison d'un node-set et d'une chaine de 
caracteres. 

Predicat sous la forme [node-set] 

Exemple 

child: :figure[ attribute: :scal e ] 

D'unemanieregenerale, un node-set, quelqu'il soit, peutetreconverti en une expression 
booleenne: la conversion donne la valeur « vrai »si etseulementsi le node-set n'est pas 
vide. 

Mais pour evaluer un node-set tel que attribute: :scaie (ne serait-ce que pour savoir 
s'il est vide ou non), il fautun noeud contexte: ce noeud contexte est eel ui qui estfourni 
par le contexte devaluation (voirci-dessus). 

II en resulte qu'uneetape de localisation telle que : 

child: :figure[ attribute: :scale ] 

selectionne les <figure>, enfants du noeud contexte courant, ayantun ensemble d' attributs 
scale non vide, e'est-a-dire (plus simplement) les <figure>, enfants du noeud contexte 
courant, ayant un attribut seal e. 

Autres exemples 

child: :figure[ parent: :paragraphe ] 
child: :*[ self::figure or self: :image ] 

Le premier selectionne les <figure> enfants du noeud contexte dont I e noeud parent est un 
<paragraphe> ; le deuxieme selectionne toutes les <figure> ou <image> enfants du 
noeud contexte. 
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Cedeuxiemeexempleestassez typique de la fagon dont on peut tester lenom d'un ele- 
ment: self: : image est une etape de localisation a evaluer ; pour cela, il faut un noeud 
contexte. Or, on est dans un predicat, done le contexte devaluation fournit le noeud en 
cours d'examen comme noeud contexte temporaire. L'axe self selectionne done un 
node-set ne contenant que le noeud en cours d'examen ; on filtre ce node-set en ne 
conservant le noeud qu'il contient, que si son nom est image et son type est element , 
puisquee'est I e type principal de noeud pour l'axe self. En fin decompte, du node-set de 
depart child: :*, qui contient tous les elements enfants du noeud contexte, sont rejetes 
tous les elements qui ne sont pas des <figure> ou des <image>. 

Predicat sous la forme [node-set = String] 
Exempl e 

child: :figure[ attribute: :scale = "0.5" ] 

Ce genre d'expression est convertie en valeur booleenne d'une facon deja evoquee a la 
section Expressions mixtes, page45. On peutfaireici uneevaluation pasapas, neserait- 
ce que pour se persuader que cen'est pas si trivial que cela, memesi au final I'expression 
se lit plutot bien. 

L'expression : 

child: :figure 

produit un node-set contenant toutes les <figure> appartenant au node-set child, lui- 
meme calcule par rapport a un certain noeud contexte. Soit { fi, f2, f3. f4 } cet 
ensemble de<figure>. 

Le predicat : attribute: :scaie = "0.5" ] s'applique a cet ensemble ; e'est-a-dire 
que pour chaque element fi, f2, f3, f4 de cet ensemble, on evalue le predicat 
[ attribute: : scale = "0.5" ] pour savoir s'il est vrai ou faux. 
Pourcefaire, on prend un element, par exemplefi.et on construi 1 1 e contexte d'eval uation : 

• le noeud en cours d'examen est f 1, et servira eventuellement de noeud contexte tempo- 
raire; 

• lenombred'elements del 'ensemble de depart est 4 ; 

• I'indice de proximite de fi estl (en toutcas, on fait cette hypothese, qui n'est pas plus 
mauvaisequ'une autre). 

M uni du contexte devaluation, on peut commencer le calcul du predicat : 

• L'expression attribute: :scaie denote un ensemble de noeuds selectionne par l'axe 
de localisation attribute et filtre par un determinant scale. Lecontenu decetaxede 
localisation se determine par rapport a un noeud contexte ; le noeud contexte est ici 
fourni par le contexte devaluation, qui donne fi. L'axe de localisation correspond 
done a I'ensembledes noeuds de type attribute attaches a fi. Cet axe est filtre par le 
determinant scale ; on obtientdonc I'ensembleA des attributs de fi ayant pour nom 
seal e (dans ce cas particulier cet ensemble a au plus un element). 
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• Le predicat a evaluer est done [ a = "0.5" ], oil A est I'ensemble precedemment 
determine. 

• Nousavonsvu comment evaluer une telle expression : elle est vraie si etseulementsi 
I'un des elements de A aunevaleurtextuelleegalea«0.5 ». 

• Done, finalement, pour chaque element fi, fz, f3, f4, on peut savoir si le predicat 

[attribute:: scale = "0 . 5"] est Vrai OU faUX. 

Ainsi I'ensemble de depart child: :figure peut etre filtre par le predicat, et le resultat 
correspond done bien a I 'ensemble detoutesles<figure>del'axe child (relatif au nceud 
contextecourant), ayantun attri but scale egal a« 0.5 ». 

Exemples de predicats dans une etape de localisation 

child: :paragraphe[ child: :figure ] 

selectionneles<paragraphe>, enfantsdu noeud contexte, qui possedentun (au moinsun) 

enfant <figure>. 

child: :chapitre[ descendant: :figure ] 

selectionne les <cnapitre>, enfants du noeud contexte, qui possedent un (au moins un) 
descendant <figure>. 

child::paragraphe[ child::* ] 

selectionne les <paragraphe>, enfantsdu noeud contexte, qui possedentun (au moins un) 
enfant. 

child: :*[ child: :f igure ] 

selectionne les elements enfants du noeud contexte, qui eux-memes possedent un (au 
moinsun) enfant <figure>. 

child::*[ self::chapitre or self::annexe ] 

selectionne les elements enfants du noeud contexte qui sont des <cnapitre> ou des 

<annexe>. 

child::paragraphe[ child: :figure[position( ) = 2] ] 

selectionne les < P aragra P he>, enfants du noeud contexte, qui possedent au moins deux 
<figure>. En effet, on filtre un node-set constitue de <paragrapne>, en se basant sur le 
fait que le node-set de ses enfants de type element et de nom figure contient un 
deuxieme element; s'il y a un deuxieme, c'estqu'il y a un premier, done qu'il y a au 
moins deux enfants. 

child::paragraphe[ child: :*[position( ) = 2][self : :figure] ] 

selectionne les <paragraphe>, enfantsdu noeud contexte, dont I e deuxieme enfant de type 
element est une <figure>. Voyez la difference avec I'exemple precedent : ici le predicat 
[ positiono = 2 ] porte sur un node-set qui contient tous les enfants de type ei ement 
(a cause de I'etoile qui teste uniquement le type principal de noeud), alors que dans 
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I'exemple precedent, le meme predicat filtrait un node-set ne comportant que des 
<f igure> : mais la deuxieme figure n'est pas forcement le deuxieme element. 

child: :paragraphe[ child: :node( )[position( ) = 2][sel f : :figure] ] 

selectionne les <paragraphe>, enfants du noeud contexte, dontle deuxieme enfant est une 
<figure>.Voyez la difference avec I'exemple precedent : ici le predicat [ positiono 
= 2 ] portesur un node-set qui contienttous I es enfants : mais le deuxieme element n'est 
pas forcement le deuxieme enfant (en plus des elements, il peut y avoir des textes, des 
commentaires, des processing-instructions). 

child: :paragraphe[ child: :node( )[self: :figure][position( ) = 2] ] 

selectionne les <paragraphe>, enfants du noeud contexte, qui possede au moins deux 
<figure>.Voyez la difference avec I'exemple precedent : ici le predicat [ positiono 
= 2 ] portesur un node-set qui necontientquedes<figure>. C et ex emple est done equi- 
valent a: 

child: :paragraphe[ child: :figure[position( ) = 2] ] 

child::*[ self : :chapitre or self : :annexe ][position( ) = lastO] 

constituele node-set des elements enfants du noeud contexte qui sontdes <chapitre> ou 
des <annexe> ; dans ce node-set, selectionne le dernier element. Ici, I'on peut imaginer 
qu'on aun I ivre avec des chapitreseteventuellement des annexes, et que les annexes, s'il 
yen a, sont placees apres les chapitres. Cette etape de localisation selectionne I e dernier 
chapitre s'il n'y a pasd'annexe, ou la derniere annexe, s'il y en aau moins une. 

/descendant: :text()[ start-witht self : :node( ) , "Horaires" ) ] 

selectionne tous les nceuds text du document qui commencent par "Horaires". start- 
witno estunfonction booleenne predefine. 

child: :mohican[ positionO = lastO ] 

selectionne le dernier des M ohicans. 
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Note 

A lire des la premiere lecture. 

Un chemin de localisation a la forme suivante: 

Chemin de localisation 

LocationPath = "/"?, LocationStep, ( "/", LocationStep ) 

Exemple de chemin de localisation relatif 

child: :chapitre/child::section 
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Exemple de chemin de localisation absolu 

/child: :chapitre/child::section 

II y a done deux formes de chemins de localisation : les chemins de localisation absolus, 
et les chemins de localisation relatifs, suivant qu'il y a ou non un «/» initial dans 
I 'expression. 

Mais, dans tousles cas, un chemin de localisation n'est compose que d'etapesde locali- 
sation. Or une etape de localisation produit un node-set; le probleme de I 'evaluation 
d'un chemin de localisation se ramifie done en deux sous problemes : d'une part savoir 
que faire de tous ces node-sets, et d'autre part, savoir comment interpreter semanti- 
quement cette cascade d'etapes de localisation. 

Evaluation d'un chemin de localisation 

Evaluation dune etape de localisation par rapport a un node-set 

Nous avons vu precedemment comment evaluer une etape de localisation par rapport a 
un nceud contexte. Nous avons vu que ce nceud contexte est indispensable pour former, 
d'apres ['axe de localisation choisi, I e node-set originel qui sera ensuitefiltre. 

N ous visons maintenant un peu plus haut : evaluer une etape de localisation par rapport a 
un node-set A non vide. Si ce node-set necontientqu'un seul element, cela ne change il 
estvrai pas grand-chose. Maiss'il encontientplusieurs? 

SoitA un tel node-set, contenant n nceuds. Pour evaluer leresultat d'une etape de locali- 
sation par rapport au node-set A, onevaluen fois cette etape de localisation en prenanta 
chaquefoisun nceud different du node-set A comme nceud-contexte. Ces n evaluations sont 
independantes les unes des autres, et produisent done n differents node-sets en resultat. 

Le resultat de cette evaluation est tout simplement un nouveau node-set, resultant de la 
fusion de ces n node-sets (union ensembliste de ces n node-sets). 

Une propriety agreable de cette operation est qu'elle prend en entree un node-set, et 
qu'ellefourniten sortieun nouveau node-set : il est done possi bled' avoi r des eval uati ons 
d'etapes de localisation enchainees en cascade. 

Evaluation d'un chemin relatif 

Un chemin de localisation relatif donneun node-set qui se calcule par rapport a un nceud 
contexte donne. 

Le node-set resultat est obtenu en enchainant, dans I'ordre ou el les apparaissent (de 
gauche a droite), les etapes de localisation qui composent le chemin, la premiere etape 
etant calculee par rapport au nceud contexte. 

Evaluation d'un chemin absolu 

U n chemin de localisation absolu se calcule comme un chemin relatif, a ceci pres que le 
nceud contexte de depart est impose : e'est la racine de I'arbre X M L du document source. 
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Cle pour la lecture d'un chemln de localisation 

Un chemin de localisation determine un ensemble de noeuds dont le calcul sefaitcomme 
indique ci-dessus, eten principe, d'un strict point devuedu langage, il n'y a pasbesoin 
d'en dire plus. Neanmoins, il est bien evident que c'est particulierement frustrant dene 
pouvoirlireun chemin de localisation « alavolee», pour en apprehenderlasemantique. 
Prenez par exemple le chemin de localisation suivant (qui n'a pourtant rien d'extraordi- 
naire) : 

parent: : chapi tre/chi 1 d : :section[position( ) = 3]/attr1bute: :niveau 

A moins d'etre entraine, il n'estpasevidentdedechiffreravueunetelleexpressionetde 
savoi r la nature exacte des noeuds selectionnes au premier coup d'ceil. 1 1 est pourtant pos- 
sible de lire « a la volee » un tel chemin de localisation, a condition de connaitre la cle de 
lecture. 

La cle de lecture est celle-ci : quand on lit un chemin de localisation pour calculer 
I 'ensemble des elements, il faut I ire I 'expression de gauche a droite; mais quand on lelit 
pour en apprehender qualitativement la signification, il faut le lire de droite a gauche (a 
I'envers). 

II est tout a fait possible de decrire un algorithmede lecture capable defaciliter grande- 
ment les debuts dans ce domaine. Nous allons le presenter en deux etapes, en traitant a 
part lecas des predi cats. 

Lecture d'un chemin de localisation sans predicat 

Le chemin de localisation est ecrit sous le forme d'une succession d'etapes de localisa- 
tion, commececi : 

etapel/etape2/etape3/. . ./etapeN 

Danscetteecriture, chaqueetapeestdelaformea::b, ou a estun nom d'axede localisa- 
tion, etb un determinant. 

• (S) : chaque«/», danscetteecriture, seprononce« des ». 

• (E) : chaqueetapeseprononce« b qui sontlesa », 

• (i) : on commence par prononcer« Les ». 

• (F) : on termineen prononcant « du nceud contexte» ou « de la racine » suivant que 
le chemin estun chemin relatif ou absolu. 

G lobalement, la phrase a prononcer pour comprendre ce que veut dire 

etapel/etape2/etape3/. . ./etapeN 

estobtenueen partant del 'etapeN, en remontant vers I 'etapei, eten appli quant les regies 
(i) au debut, (F) alafin, et (E) (S) achaqueetape, sauf la derniere : 

(I) (E)(S) ... (E)(S) (E)(S) (E) (F) 
etapeN etape3 etape2 etapei 
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Ainsi par exemple, lechemin : 

child: :chapitre/child: :section/attribute: :niveau 

est lu en appli quant les regies : 

( i ) : L es 

( e ) : niveaux qui sont I es attri buts 

cs) : des 

(E) : sections qui sont les enfants 

(S) : des 

(E) : chapitres qui sont les enfants 

(F) : du nceud contexte 

le qui donne : Les niveaux qui sont attributs de sections qui sont les enfants des cha- 
pitres qui sont les enfants du na?ud contexte . 

II peut parfois arriver qu'un nom d'axe soit assez peu compatible avec le pluriel (par 
exemple parent ou self, encore que self intervienne plus souvent dans un predicat) ; 
dans ce cas on rectifie, pour rendre la phrase plus conforme a I'intuition. 

parent: : chapi tre/chi 1 d : :section/attribute: :niveau 

Ce qui donne : les niveaux qui sont les attributs des sections qui sont les enfants du cha- 
pitre qui est le parent du noeud contexte. 

Lecture d'un chemin de localisation avec predicats 

La presence de predicats perturbe incontestablement la fluidite de lecture d'un chemin de 
localisation, parce qu'elle contrarie le sens retrograde de lecture du chemin : 

.../a::b[c]/etapeN 

L orsqu'on commence la phrase de description, en partant de la fin, et qu'on arrive a a : : b, 
on doit a ce moment teni r compte d'un predi cat cense restrei ndre un node-set construit en 
partant du debut, et non en partant de la fin. Or a ce point, on ne connait pas encore le 
node-set qu'il s'agitdefiltrer. Ceproblemen'est pastoujours bloquant, car certains pre- 
dicats, notamment ceux qui ne font pas appel a la fonction predefinie positiono, 
s'accommodent assez bien dela souplessedeia langue naturelle. 

chi Id:: chapi tre/chi ld::section[child::figure]/attribute:: niveau 

ecture : 
( i ) : L es 

( e ) : niveaux qui sont I es attri buts 
cs) : des 
(E) : sections (ayant des enfants^gure) qui sont les enfants 
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• ( s ) : des 

• (E) : chapitresqui sontlesenfants 

• (F) : du noeud contexte 

lei, parler de <section> sans restriction, ou d'elements <section> ayant des enfants 
<f igure> ne change pas grand chose a la structure de la phrase qui reste comprehensible, 
memesi l'originedeces<section> estmiseen attenteet reporteeala fin dela phrase. 
Cependant, lorsqu'un predicat fait usage de la fonction positiono, il est plus difficile de 
formuler une phrase comprehensible, parce que cette position est relative a un node-set 
enumerable que I'on ne connait pas encore. 

Une solution, qui marche a tous les coups, consiste a mettre en attente le predicat, au 
moyen d'unenoteavec renvoi. 

child: : chapi tre/chi 1 d : :secti on [positi on ()=2] /attribute:: niveau 

(i) : Les 

(E) : niveaux qui sont les attributs 

(S) : de(s) 

(E) : certaines(l) sections qui sontlesenfants 

( s ) : des 

(E) : chapitresqui sontlesenfants 

(F) : du noeud contexte 

(note i) uniquement celle qui a la position 3 dans I'ensemble de sections dontil est 
question. 

Lecture d'un chemin de localisation dans un predicat 

II peut arriver de rencontrer un predicat qui contienne lui-meme un chemin de localisa- 
tion : 

child: :paragraphe[ child: :figure/attribute: :scal e ] 

II y a alors une difference essentielle entre la lecture d'un chemin de localisation en tant 
quetel, et la lecture d'un chemin de localisation faisant partied'un predicat, commeci- 
dessus. En effet, dans le premier cas, il s'agit deconstruire un node-set dont la comple- 
tude est primordiale; dans le deuxieme cas, il s'agit seulement d'evaluer ce node-set 
comme expression booleenne : il peut bien y avoir 3000 elements dans le node-set, peu 
importe: un seul suffit pour savoir qu'il estnon videetdonner la reponse booleenne. 

II en seraitdemSme, si Ton avait: 

child: :paragraphe[ child: :figure/attribute: :scale = "0.5" ] 

On n'aurait que faire de connaitre in-extenso le node-set child: :figure/attribute: : 
scale, i I nous suffiraitde savoir si au moinsun element du node-set est egal a "0.5". 
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Dans ces conditions, il devi ent possible del ire I echemin de localisation du predicat dans 
lesens normal, car on n'a plus besoin deformuler une phrase qui exprime la total ite du 
contenu des etapes de localisation traversers. 
Ainsi, les etapes de localisation ci-dessuspeuventselirerespectivement: 

• les <paragraphe> (ayant un enfant <figure> ayant un attribut scale) qui sont les 
enfants du nceud contexte ; 

• les <paragraphe> (ayant un enfant <fi gure> ayant un attribut scale egal a "0.5") qui 
sont les enfants du nceud contexte. 

Naturellement, les expressions « ayant un enfant » ou « ayant un attribut » signifient en 
fait « ayant au moins un enfant »ou « ayant au moins un attribut ». 

Remarque 

II ne faut pas considerer que lorsque revaluation de deux predicats exprimes sous la forme de chemins de loca- 
lisation donne le meme resultat, les chemins de localisation associes sont equivalents. 

Par exemple, les deux predicats ci-dessous donnent le meme resultat : 

child: :paragraphe[ child: rfigure/attribute: :scale ] 
child::paragraphe[ child: :figure[ attribute: :scale ] ] 

Pourtant, les chemins de localisation associes, a savoir child: :figure/attribute:: 
scale et child: :figure[ attribute: : scale ] sont d iff erents, puisque I e premier selec- 
tionne des attributs scale, alors que le deuxieme selectionne des elements <f i gure>. 1 1 se 
trouve simplement que ces deux chemins de localisation selectionnent des node- sets tou- 
jours simultanement vides ou toujours simultanement non vides, ce qui les rend equiva- 
lents du point de vue de la conversion en booleen. 

Exemples de chemins de localisation 

| child: : bloc/descendant: : figure 

selectionne les <f 1 gure> qui sont des descendants des <bi oc> enfants du nceud contexte. 

chi ld::bloc[position()=3]/child::figure[position()=l] [attribute: :type='gif] 

selectionne les <figure> ayant un attribut "type" egal a "gif" qui sont le premier enfant 
direct du troisieme <bi oc> enfant du nceud contexte. 

parent: :node() /chi Id: : figure 

selectionne les <figure> enfants d'un nceud quelconque parent du nceud contexte. 

/descendant: :figure[position() = 42] 

selectionne la figure qui a la position 42 parmi les descendants de la racinedu document. 
II s'agitdonc dela quarante-deuxieme<figure> dans I'ordrede lecture du document. 

/child::doc/child::chapitre[position()=5]/child::section[position()=2] 



Le langage XPath 

Chapitre 2 

selectionne la deuxieme <section> enfant du cinquieme <chapitre> enfant de I 'element 
<doc> enfant de la racinedel'arbreXM L. 

child: :chapitre[ descendant: : note/child: :paragraphe/ 
attribute: :al ignement = "centre" ] 

selectionne les <chapi tre> enfants du nceud contexte, qui ont pour descendants des <note> 

ayantpourenfantsdeS<paragraphe> ayantun attributal ignement egal a "centre". 

/descendant: :*[ not( child::* ) ] 

selectionne I esfeui I les de I 'arbreX ML du document source, c'est-a-di re les elements qui 
n'ont pasd'enfant. Sans le predicat, on selectionne tous les elements qui fig u rent parmi 
les descendants de la racine; le predicat [ child::* ] filtrece node-set en ne retenant que 
les elements qui ont au moinsun enfant, quel qu'il soit; le predicat [ note child::* ) ] 
agit de facon inverse, en ne retenant que les elements qui n'ont aucun enfant. 

Formes courtes des chemins de localisation 
Principe 

Vous I'aurez remarque, XPath est un langage assez verbeux ; e'est pourquoi il existe des 
abreviations standard pour certaines constructions frequemment utilisees. Ces abrevia- 
tions simplifient lesecritures, mais pas la comprehension des expressions un peucompli- 
quees, car el les ont tendance a masquer le detail des relations qui existent entre les 
differents constituants d'une expression, alors que ces details sont indispensables pour 
appliquer I'algorithme de lecture (voir Cle pour la lecture d'un chemin de localisation, 
page 64). Lorsqu'on bute sur une expression difficilement comprehensible, la premiere 
chose a fai re est done d'eli mi nertoutes les abreviations pour reveniraux formes completes. 

Cecietant, il estvrai que dans les expressions usuel les qui ne posent aucun problemede 
comprehension, ces abreviations sont les bienvenues. On noteraquel'emploi de la forme 
courte de child: :nom revient a sous-entendre la relation de parente enfant de dans les 
phrases de description d'un chemin de localisation. 







Tableau 2-1 


I - Abreviations standard 


Forme longue 






Abreviation 


child: :nom 






nom 


child::* * 


attribute: :nom 






@nom 


attribute::* 






@* 


[positionO = x] [x] 


self::node() 


parent: :node() 


/descendant-or 


-self: 


:node()/ 


// 
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Exemples de chemins de localisation en formes courtes 

Voici quelques exemples d'utilisation de ces formes courtes ; pour chacune, on donne la 
forme longue equivalente. 



figure 



Forme longue : 
child: :figure 



selectionne les <figure> qui sont des enfants directs du nceud contexte. 

textO 
child::text() 

selectionne les enfants directs du nceud contexte qui sont des nceuds de type text. 

//figure 

Forme longue : 

/descendant -or- self : :node( ) /child: :figure 

selectionne les <f igure> qui sont des enfants directs de n'importe quel nceud descendant 
dela racinedel'arbreXML (done sel ecti o n ne to utes les figures, ouqu'ellessetrouvent 
dans le document). Si <f i gure> est la racine du document, el I e est aussi selectionnee, car 
la racine du document est enfant direct dela racinedel'arbreXML (voir Nceud de type 
root, page 31). 

bloc//figure 



-self: :node( ) /child: :figure 

selectionne les <figure> qui sont des enfants directs ou indirects des <bioc> enfants du 
nceud contexte. 

bloc[3]/figure[@type = 'gif'][l] 



child: :bloc[position()=3]/child::figure[position()=l] 

[attribute: :type='gif ' ] 

selectionne les <figure>ayantun attribut "type" egal a "gif" qui sont le premier enfant 
direct du troisieme <bi oc> du nceud contexte. 



Forme longue : 

parent: :node() /child: : figure 

selectionne les <figure>du parent du nceud contexte. 
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.//paragraphe 

Forme longue : 

self: :node( ) /descendant- or -self: :node( ) /child: :pa rag raphe 

selectionneles <paragraphe> qui sont des enfants directs ou indirectsdu nceud contexte. 

//*[not(*)] 

Forme longue : 
| /descendant-or-self : :node( )/child: :*[not( child: :*)] 

selectionneles feuilles de I'arbre X M L . I ci la forme longue est plus facilea comprendre : 
les elements (n'ayant pas d'enfant) enfant den'importe quel nceud de I'arbre (y compris 
laracine). 

Variantes syntaxiques 

Expressions diverses 

1 1 n'y a que tres peu de possi bi I i tes pour former des expressi ons renvoyant des node-sets : 
on dispose de chemins de localisation, qui sont en eux-memes des expressions renvoyant 
un node-set, dereferences a des variables contenantun node-set (mais les affectations de 
ces variables ne sont pas du ressortdu langage XPath), de parentheses, del'operateur | 
(reunion ensembliste), et d'appels a des fonctions predefines renvoyant un node-set (a 
savoirunefonctionproprement XPath, id( ), et deux fonctions XSLT utilisablesdansune 

expression XPath, key() etdocumentO). 

Voici quelques exemples d'expressions manipulant ces divers ingredients : 

(/descendant: :figure[position( ) = 42]) 

renvoie un node-set contenant la quarante-deuxieme <figure> dans I'ordre de lecture du 
document. Cet exemple a deja ete vu, mais sans les parentheses, qui dans ce cas ne ser- 
vent a rien, mais ne font pas non plus de mal. Quoique... Ces parentheses ne font-el les 
vraiment pas de mal ? Voyez la section Enumeration d'un node-set renvoye par une 
expression, page 71. 

/descendant: :figure | /descendant: :image 

renvoie un node-set contenant reunion de toutes les figures et de toutes les images du 
document. 

/ | document; 'charteGraphique.xml ' ) 

renvoi e un node- set contenant reuni on de I a raci ne de I 'arbre du document source et de I a 
racine de I'arbre d'un document auxiliaire, contenu dans le fichier 'charteGraphi- 
que.xml '. 

/descendant: :figure[ @type = 'gif ] | Smeslmages 
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renvoie un node-set contenant reunion de tous les elements <figure> ayant un attri but 

typeegal a "gif" et des elements du node-Set $mes Images. 

Evaluation d'une etape de localisation par rapport a un node-set 
renvoye par une expression 

Nousavonsvu a la section Evaluation d'une etape de localisation par rapport a un node- 
set, page 63, comment faire pour evaluer une etape de localisation par rapport a un 
node-set. Maisrien n'empeche que le node-set soit renvoye par une expression ; en voici 
quelquesexemples: 

document ( 'charteGraphique.xml ' )/descendant: :figure[ @type = 'gif ] 

selectionne le node-set des elements <figure> (ayant un attri but type egal a "gif") qui 
sont les descendants de la racinedel'arbreXML du document auxiliairecontenu dansle 

fiChier "charteGraphique.xml ". 

(/descendant: :figure | /descendant: :image)/attribute: :scale 

selectionne les scale qui sont les attri buts des nceuds appartenant a la reunion des node- 
sets /descendant: :figure et /descendant: :image. A noter qu'On aurait pu aUSSi ecrire 

I 'expression : 

/descendant : :*[ self :: figure or self::image ]/attribute: :scale 

qui aurait selectionne le meme node-set. 

SmonDocument /child: :chapit re/sect ion 

selectionne les <section> enfants des <chapi tre> enfants des elements contenus dans le 

node-Set SmonDocument. 

Notez qu'une expression formeed'un chemin de localisation suivi d'une expression ren- 
voyant un node-set n'a aucun sens : 

child: :chapitre/section/$monDocument <!-- aucun sens !! --> 
child::chapitre/(child::section) <!-- aucun sens !! --> 

Enumeration d'un node-set renvoye par une expression 

Lorsqu'un node-set est constitue par une etape de localisation, il estassocie aun axede 
localisation qui est soit direct, soit retrograde. Cela permet de definir dans tous les cas 
des indices deproximite (voir Indices de proximite, page 53), etdonc dedonner un sens 
a la notion d'enumeration d'un node-set: un node-set est enumere (quand besoin est) en 
suivantl'ordredes indices deproximite. 

M aissi le node-set est renvoye par une expression quelconque, on perd la notion d'axede 
localisation, done d'indices de proximite, done d'enumeration. Dans ce cas, la regie est 
de choi sir arbitral rement I 'ordre de lecture du document pour enumerer les elements. 
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Regie pour definir remuneration d'un node-set 

Deux cassontaenvisager : 

• soitle node-set fait partie d'une etape de localisation ; danscecas, un axe de localisa- 
tion estdefini, done les indices de proximite sont definis, ettoute enumeration sefera 
suivant I'ordre des indices de proximite ; 

• soit le node-set provient d'une expression X Path qui n'est pas une etape de localisa- 
tion : dans ce cas les enumerations se feront dans I 'ordre de lecture du document. 

Exemple 

Le basculement entre ces deux cas peut etre assez subtil : le standard XPath donne un 
exemple limite qui est assez parlantdece point devue: 

Enumeration imposee par indices de proximite 

j preceding-sibl i ng : :figure 

Enumeration par defaut. suivant I'ordre de lecture du document 

| (preceding-sibling: :figure) 

Dans le premier cas, on a une etape de localisation, done I'axe de localisation est deter- 
mine, et les indices de proximite interviennent pour donner I'ordre d'enumeration. 

Dans le deuxieme, I'expression precedente est mise entre parentheses. Cela produit 
I'effet decalculer un nouveau node-set, qui estevidemmentidentiqueau precedent, mais 
qui n'apaslestatutdenode-setfaisantpartied'une etape de localisation. II en resulteque 
toute enumeration de ce deuxieme node-set se fera dans I'ordre de lecture du document, 
exactemental'inversedu premier cas, puisque I'axe choisi estun axe retrograde. 

Comme nous I'avons dit, cet exemple est un exemple limite : il ne faut pas croire que 
dans I a prati que, on est sans cesse confronts a ce genre de subti lite. M ais il n'est pas mau- 
vais de I 'avoir vu, et de se souvenir que ^enumeration d'un node-set depend de facon 
cruciale de la prise en compte ou non d'un axe de localisation. 

Application d'un predicat a une expression renvoyant un node-set 

II est possible d'appliquer un predicat a une expression renvoyant un node-set. Cequ'on 
a vu a la section Predicats, page 57, e'est I 'application d'un predicat a un node-set forme 
lors d'une etape de localisation. La difference, ici, est que le node-set n'est plus neces- 
sairement lie a une etape de localisation, done, si besoin est (notamment si la fonction 
predefine posi ti on o est employee dans le predicat), la regleindiqueea la section pre- 
cedente s'appli que. 
En reprenant I'exemple limitede la section precedente, on aura : 

preceding-sibl ing: :figure[ positionO = 1 ] 

constitue I e node-set NS des<figure> qui sontdes preceding-sibling du nceud contexte; 
dans ce node-set, selectionne la premiere <figure>. Comme I'axe preceding-sibling est 
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un axe retrograde, la figure selectionnee est done la derniere dans I'ordre de lecture du 
document. 

(preceding-sibl ing: :figure)[ positionO = 1 ] 

constitue le node-set N S des <f i gure> qui sont des precedi ng-si bi i ng du nceud contexte ; 
dans ce node-set, selectionne la premiere <f igure>. Comme ce node-set n'est lie a aucun 
axe de localisation, e'est I 'ordrede lecture du document qui intervient, et la figure selec- 
tionnee est done la premiere dans I'ordre de lecture du document. 
Voici maintenantd'autresexemples : 

I (//paragraphe | //noteBasDePage)[ child: : text ( ) 

[ containst self : :node( ) , "predicat" ) ] 

] 

selectionne tous les paragraphes ou notes de bas de page du document, pourvu qu'ils 
aient au moins un enfant de type text qui contienne « predicat » dans un nceud qui soit 
self. Ou encore, en simplifiant lesredondances, pourvu qu'ils aient au moins un enfant 
de type text qui contienne « predicat ». A utrement dit : selectionne tous les paragraphes 
ou notes de bas de page qui parlent de predicat. 

$mes Images [©type = 'gif'] 

selectionne les elements du node-set reference par la variable $mes images, ayant un attri- 

buttypeegal a 'gif. 

$p[ countt self::node() | $q ) = count( $q ) ] 

selectionne les elements du node-set reference par la variable $p, qui appartiennent aussi 
au node- set reference par la variable $q. C 'est la fameuse expression qui permet de calcu- 
ler I 'intersection dedeux node-sets: voir Appartenanceet test d Inclusion, page 44. 
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Ce chapitre a pour but de rendre intelligible le fonctionnement de ce langage, non pas en 
le montrant en action, car le voir fonctionner n'explique rien, mais en allant au coeur des 
mecanismesqui regissentson comportementdynamique. 

Pourcela, nous presenterons la structure generaled'un programme XSLT, qui metclaire- 
menten evidence I es deux piliersdu langage, que sont le motif et I e model ede transfor- 
mation ; puis nous demonterons le moteur de transformation, en faisant ressortir les 
etapes du processus general de traitement. Ensuite nous revisiterons en detail, d'abord 
les motifs et la concordance de motifs, puis les deux modeles de transformation fonda- 
mentaux, represented par les instructions xsi :vaiue-of etxsi :appiy-tempiates, dontla 
comprehension aboutit de facto a celle des autres instructions de transformation, qui ne 
sont rien d'autre que des variantes polymorphes et contingentes de ces deux-la, sans rien 
denouveau dans I 'essence meme des mecanismes. 

Structure d'un programme XSLT 

Un document (ou programme) XSLT estun document XML, dontla racine est I 'element 

stylesheet, et dont le domaine nominal est "http://www.w3.org/1999/XSL/Transform", 

generalementabregeen "xsi :". 

Un programme XSLT a done I'allure suivante : 

<?xml version="1.0" ?> 

<xsl : stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> 

</xsl :stylesheet> 

L'abreviation de domaine nominal "xsi:" est celle qui est traditionnellement utilisee. 
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M ais bien stir, comme toute abreviation de domaine nominal, die n'est qu'une abrevia- 
tion possible, etl'on estlibred'en choisir une autre (par exemplexsit:), du moment que 
le domaine nominal restelememe: 

<?xml version="1.0" ?> 

<xslt: stylesheet xmlnsixsl t="http://www.w3.org/1999/XSL/Transform"> 

</xslt:stylesheet> 

Remarque 

La declaration de ce domaine nominal etant obligatoire, tous les elements propres a XSLT seront done neces- 
sairement prefixes par I'abreviation de domaine nominal choisie ; autrement dit, toute balise dont le nom ne 
serait pas prefixe par "xsi : " (en supposant que e'est celle-la que Ton a choisie) serait consideree par le proces- 
ses XSLT comme du XML ordinaire n'ayant rien a voir avec XSLT. 

Comme un programme XSLT est un document XM L, tous les aspects lexicaux sont du 
ressort d'XML et non d'XSLT : la syntaxe pour les noms d'elements, d'attributs, les 
caracteres interdits dans les valeurs d'attributs, etc., tout ceci est determine par le langage 
X M L et non par X SLT proprement dit. 

Elements XSLT, instructions, et instructions de premier niveau 

Un element XSLT est un element XML dans le domaine nominal deXSLT, done dela 
forme <xsi :xxx>, si toutefois I'abreviation choisie est bien xsi : (ce que nous supposons 
etrevrai partout dans la suite). 
Une instruction est un element XSLT. 

Certaines instructions sont des instructions de premier niveau : ce sont des elements 
XSLT enfants directs dela racine<xsi :styiesheet>. 

Remarque 

Le standard XSLT 1 .0 parle de « top-level element » (que nous avons traduit par « instruction de premier 
niveau », puisque pour nous, « element XSLT » et « instruction » sont synonymes), et emploie le mot « instruc- 
tion » dans la grammaire XSLT, mais sans vraiment le definir. 

L'allure generale d'un programme XLST est done celle-ci : 

<?xml version="1.0" ?> 

<xsl: stylesheet xmlns :xsl="http://www.w3.org/1999/XSL/Transform"> 
<!-- instructions de premier niveau --> 

<!-- fin des instructions de premier niveau --> 
</xsl: stylesheet) 

Les differentes instructions sont assez peu nombreuses, et nous les verrons au fur et a 
mesure que nous en aurons besoin dans la suite de ce livre ; la plus importante d'entre 
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elles, <xsi :tempiate match=". . . ">est celle qui permet de definir une regie de transfor- 
mation, etc'estbien sur par elle qu'il faudra commencer. 

L e standard X SLT 1.0 donne au tout debut un exempl e de programme X SLT tres varie en 
instructions: 

<xsl :stylesheet 

xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> 

<xsl : import href=". . ."/> 

<xsl :include href=". . ."/> 

<xsl : st rip- space elements=". . ."/> 

<xsl :preserve-space elements^" . . . "/> 

<xsl:output method=" . . . "/> 

<xsl:key name="..." match="..." use="..."/> 

<xsl :decimal -format name=" . . . "/> 



<xsl 


namespace-alias 




stylesheet-prefi 




result-prefix=" . 


<xsl 


attribute-set n 


</xs 


:attribute-set> 


<xsl 


variable name=" 


<xsl 


param name=".. . 


<xsl 


template match= 


</xs 


:template> 


<xsl 


template name=" 


</xs 


: tempi ate> 


</xsl:stylesheet> 



II nes'agitpasici d'expliquer a quoi correspondent ces instructions, maissimplementde 
prendre contact avec i'allure d'un programme XSLT. 

Voici un autre exemple, moins riche en variete d'instructions, mais complet, sans points 
de suspension : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='htmr encoding=' ISO-8859-1' /> 

|<xsl:template match="/"> 
<html> 
<head> 
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<title><xsl:value-of select='7Concert/Entete'7X/title> 
</head> 
<body bgcolor="white" text="black"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :template> 

<xsl :template match="Ent§te"> 

<p> <xsl : value-of select="."/> presentent </p> 
</xsl :template> 

<xsl :template match="Date"> 

<H1 align="center"> Concert du <xsl : value-of select="."/> </Hl> 
</xsl :template> 

<xsl :template match="l_ieu"> 

<H4 align="center"> <xsl : value-of select="."/> </H4> 
</xsl :template> 

<xsl : tempi ate match="Ensemble"> 

<H2 align="center"> Ensemble <xsl :val ue-of select=°."/X/H2> 
</xsl :template> 

<xsl :template match="Compositeurs"> 

<H3 align="center"> Oeuvres de <br/> <xsl :val ue-of select=".'7> </H3> 
</xsl :template> 

</xsl:stylesheet> 

De toutes les instructions, la plus importante, celle qui caracterise le plus le langage 
XSLT, c'est I 'instruction <xsi template match="...">, qui definitcequ'on appelleune 
regie de transformation : XSLT est un langage de transformation base sur des regies de 
transformation. 

Regies de transformation 

XSLT est un langage declaratif, a la maniere de Prolog. On ne decrit pas des actions a 
enchainer en sequence, mais des regies de transformation a appliquer suivant les cas qui 
se presentent ; de sorte qu'en general, I'ordre dans lequel ces regies sont enoncees n'a 
aucune influence sur lefichier resultat. 

Un processeur XSLT traite un document XML en parcourant les elements de I'arbre 
XML correspondant, eten appliquant a certains d'entreeux une regie de transformation 
choisie parmi I 'ensemble des regies constituant le programme X SLT. 

Un programme XSLT se compose done essentiellement d'une serie de regies, chaque 

regie etant constitute de deux parties : 

• Un motif (pattern). Exprime en XPath, il ditsi I 'element courant est ou non atraiter. 
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• Un modelede transformation (template), qui ditparquoi remplacer I 'element cou- 
rant, dans le cas ou il correspond au motif. 

Remarque 

Pour etre complet, ajoutons qu'un programme XSLT peut aussi integrer, en tant qu'instruction, des elements plus 
proches de la programmation classique, qui s'apparentent aux variables et aux fonctions, et permettent de 
realiser des algorithmes. De ce point de vue, XSLT est un langage fonctionnel pur. Pour les connaisseurs, disons 
qu'il ressemble a un Caml hyper-light (ce qui fait de XSLT un langage tenant a la fois de Caml et de Prolog). Pour 
les autres, disons en un mot qu'un langage fonctionnel est un langage de programmation dont Tune des carac- 
teristiques (en fait la seule qui nous interesse pour comparer a XSLT) est que la notion de variable dont la valeur 
peut evoluer au cours du temps n'a aucun sens. On est done dans un monde extremement different de celui de 
C ou de Java : il ne faut surtout pas projeter sur XSLT les connaissances qu'on peut avoir de la notion de variable 
ou de fonction tirees de la pratique de C ou Java. 

Mais XSLT n'est pas encore un langage de plus pour I'algorithmique : il y en a deja suffisamment comme ga sur 
le marche ; e'est un langage de manipulation d'arbres, et en tant que tel, ce sont les regies XSLT (avec leur motif 
et leur modele de transformation) qui sont essentielles, et non pas les possibilites offertes dans le domaine de la 
programmation algorithmique. Cela ne veut d'ailleurs pas dire qu'elles sont inutiles ; elles sont meme parfois 
indispensables, mais n'ont de sens que comme complement a I'essentiel (la manipulation d'arbre). 

Forme d'une regie XSLT 

Une regie XSLT (ou regie de transformation), constitute d'un motif etd'un modelede 
transformation, sepresente sous la forme d'une instruction <xsi : tempi ate> dont I 'attri but 
match fournit le motif, et dont les nceuds enfants constituent le modele de transformation : 



<xsl : 


template match=" . 


..pattern. 




U— modele de tra 


nsformatic 




:!-- fin du modele 


i de transl 


</xsl 


:template> 





Le motif, ou pattern, fourni en tant que valeur de I 'attri but match, s'exprime sous la 
forme d'une expression X Path verifiant des contraintes parti culieres. 

Note 

Lexistence de ces contraintes ne doit pas suggerer que XPath est un langage mal congu car trop puissant pour 
I'usage qu'on en a ; en effet, XPath, en tant que langage general d'expressions designant des sous-arbres dans 
un arbre XML, est utilise aussi bien pour XSL que pour XPointer (et bientot XQuery). La puissance expressive de 
ce langage n'est done pas forcement utilisable en totalite dans tous les contextes. 

Modele de transformation 

L e modele de transformation decrit ce par quoi il faut remplacer le sous-arbre que le motif 
designe (ou les sous-arbres si le motif en designe plusieurs). Ce peut etre du texte simple : 

<!-- modele de transformation --> 
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<!-- fin du modele de tra 



Ce peut etre aussi du texte agremente de valeurs tirees de sous-arbre(s) designe(s) par 
une expression XPath quelconque (ici, pas de restriction sur I'emploi deXPath) : 

<!-- modele de transformation --> 

a bla ... 

i, une instruction XSLT qui va provoquer 1 'insertion, 

:et endroit, de la valeur de l'attribut "nom" de 1 'element <personne> 

i se trouve a tel endroit dans 1'arbre XML du document 
bla bla ... 
<!-- fin du modele de transformation --> 

Bien sur, on peut deja se douter que la valeur de l'attribut nom de I 'element <personne> se 
trouvant a tel endroit dans le document XML sera exprimee sous la forme d'une expres- 
sion XPath de la forme: 

.../.. ./personne/attribute: :nom 

Comme toute la puissance de XPath est ici utilisable, on imagine facilement qu'il y a 
beaucoup d'autres possibilites : recuperation du contenu d'un element, evaluation d'une 
fonction sur un ensemble d'elements, et tout autre calcul du meme genre, pourvu qu'il 
soitexprimable en XPath : 



<!-- modele de transformation --> 




bla bla ... 




inserer ici le contenu de 1 'element <desc 


ription> 


tel endroit dans Tarbre XML du document 




bla bla ... 




<!-- fin du modele de transformation --> 




Ou encore: 




<!-- modele de transformation --> 




bla bla ... 




inserer ici la somme des valeurs des attr 


ibuts "pr 


des elements <produit> qui se trouvent a 




tels et tels endroits dans l'arbre XML du 


document 



<!-- fin du modele de transformation --> 

Par ailleurs, le texte peut lui-memeetre balise en XML (par exemple en XHTML ou 
HTML4): 

<!-- modele de transformation --> 

<BR/> bla bla ... 

<P> 

inserer ici la somme des valeurs des attributs "prix" 

des elements <produit> qui se trouvent a 

tels et tels endroits dans l'arbre XML du document 

</p> 

<Hl>bla bla ...</Hl> 

<!-- fin du modele de transformation --> 
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II fautrappelerici quelebalisageeventuel enXM L (ou varianted'XM L) du texte consti- 
tuant le model e de transformation doit respecter la structure de document bien forme 
imposeepar I e standard XML. II est done impossible debaliser letexteen HTM L ordi- 
naire, a cause des balises comme <t>r>, <p>, <hr>, etc. qui n'ont pas necessairement de 
balisedefermetureassociee. 

La raison decette restriction estfort simple : un programmeXSL est avant tout un docu- 
ment XML bien forme; lorsqu'on lance le processeur XSLT, le document XSL est 
d'abord I u de facon standard par un parseur X M L , qui ne fait aucune difference de traite- 
ment entre les balises prefixees par "xsi :" et les eventuelles autres. Une fois construit 
I'arbreXM L du document XSL, le processeur XSLT entre en action ; il parcourt I'arbre 
XML obtenu, en interpretant les balises prefixees par "xsi :" comme autant destruc- 
tions, et en considerant les autres comme des bribes de donnees. 

Modele de transformation litteral 

Un modele de transformation litteral estun model ede transformation qui necontientque 
du texte et des elements XM L en dehors du domaine nominal deXSLT. C'est done un 
model ede transformation qui necontientpasd'instruction XSLT. Un element XM L non 
XSLT qui figure dans un model ede transformation s'appelleun element source litteral. 



si : tempi ate match=". . .pattern. . ."> 
<!-- modele de transformation litteral--> 
Detail du rez-de-chaussee : 
<RDC> 

<cuisine surface='12m2'> 

Evier inox. Mobilier encastre. 
</cuisine> 
<WC> 

Lavabo. Cumulus 200L. 
</WC> 
<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 
Carrelage terre cuite. Grande baie vitree. 
</sejour> 
</RDC> 

<!-- fin du modele de transformation 1 itteral --> 
</xsl :template> 

Ce modele de transformation est litteral, parce qu'il ne contient que du texte et un element 
XML non XSLT (<rdc>, ettoutesa descendance), qui est done un element source litteral. 

Un premier exemple de programme XSLT 

A pres ce survol tres rapide de la forme generate d'une regie XSLT, nous allons mainte- 
nant revenir sur I 'exemple vu un peu plus haut, afin de ne pas le quitter sans savoir ce 
qu'il peut produi re comme resultat. 



Au coeur du langage XSLT 

Chapitre 3 



Cet exemple, visible a la figure 3-1, n'est pas destine a expliciter le principe de fonction- 
nementdu langage XSLT, carmalgreson apparente simplicite, il esttropcompliquepour 
un debut; il ne faut done s'attacherqu'aapprehender la structure general e, sanss'arreter 
sur le detail des divers constituants. 



Concertxsl 










<?xml version="1.0" encoding="UCS-2"?> 
<xsl:stylesheetxmlns:xsl="http://www. w3.org 
<xsl:output method='htmr encoding='ISO-88 

<xsl:template match="/"> 

<title> _^---~~~~~^ 

<xsl:value-of select="/Concert/Entete"/> 
<title> 

<body bgcolor="white" text="black"> 


1999/XSL/Transform"version="1.0"> 
59-17> 






D^^-^- Netscape: «Les Concerts dVuiacreon» E 


B 


► ► ■■■■ ► ■■■■ 




:: 

/ Concert du Jeudi 17 


— 


S app, yt e m p,a t e S/ > , Aanvier2002, 20H30 

<html> / / 

<xsl:template> / / _ CMpelfe de 3 Uisuies 




<xsl:template match="Entete"> / / ^^ 

<p><xsi:vaiue-ofseiect= "."/> , Ensemble «A deux violes esgales» 

presentent</p> / ./ jt 
</xsl:template> /.- / n j 

J/ / ^Oeuvres de 




<xsl:template match="Lieu"> s^ 1 
<H4 align="center"> ^ / 
<xsl:value-of select="."/> / 
<H4> / 

</xsl:template> / 


iA. Marais^D. Castello, F. Rognoni 


~ 


rf*-»-i / w&t^^m \& 






<xsl:template match="Date"> / / 
<H1 align="center"> / / 
Concert du <xsl:value-of select^ 1 . "/; 
<H1> / 

</xsl:template> / 


/ 


Co/lcert.xml | 






<fxml version="1.0" encoding="UCS-2" standalone="yes"?> 
<Concert> 




<xsl:template match="Ensembley , 
<H2 align="center"> / / 
Ensemble / 
<xsl:value-of select="."/></H2> 

</xsl:template> / 




<Entete>«Les Concerts d'Anacreon» </Entete> 
<Date>J eudi 17 J anvier 2002, 20H30<Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<E nsemble> «A deux violes esgales» </E nsemble> 




<xsl:template match="Composite<jrs"> 
<H3 align="center">/ 
Oeuvres de <br/> ' 
<xsl:value-of select="."/></H3> 

</xsl:template> 

</xsl:stylesheet> 




<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
</Compositeurs> 

</Concert> 













Figure 3-1 

Un exemple de transformation XML vers HTML. 
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M algre tout, il reste suffisamment simple pour qu'on puisse intuitivement entrevoir de 
quelle manierei I transforme en HTML lefichierXM L propose en entree. 

C'est ainsi qu'en observant lefichierXM L donne et le resultat obtenu, on imagine bien 
que la transformation XSL consistetoutsimplementadeshabiller I etextedesesdi verses 
balisesXML pour I e rhabi 1 1 er de bal i ses HTML (XHTML plus exactement, pour conser- 
ver la structure de document bien forme), en respectant I'ordre dans lequel les elements 
XML apparaissent dans le fichier donne. Notez bien qu'il ne s'agit pas de I'ordre dans 
lequel les regies sont donnees : voyez en particulier le croisement entre la regie pour le 
lieu etla regie pour la date. 

Rien de bien extraordinaire dans tout cela, une simple feuille de style CSS pourrait en 
faire autant. Quoique ... Aviez-vous remarque que le contenu de I 'element <Entste> 
intervient deux fois dans le resultat, une fois comme titre de la fenetre du navigateur, et 
une fois dans le texte proprement dit ? 

Lancement du processeur XSLT 

A titre indicatif, et pour fixer les idees, voici la commande (avec Saxon) qui a permis 
d'obtenir le resultat ci-dessus : 

Ligne de commande (d'un seul tenant) 

Java -classpath "C:\Program Files\JavaSoft\SAXON\saxon. jar; " 

com. icl .saxon. Stylesheet -oConcert.html Concert. xml Concert. xsl 

Principe de fonctionnement d'un processeur XSLT 

Leprincipede fonctionnement d'un moteurXSLT est important a comprendre, car i I est 
normalise, done parfaitement previsible ; ecrire(ouconcevoir) une feui I lede style XSLT, 
c'est done prevoir lecomportementdu processeur XSLT face a la feuille de style qu'on 
sepreparealui proposer. 

Note 

Cela ne veut pas dire que le resultat produit par un programme XSLT soit toujours facile a prevoir dans ses 
moindres details. Mais en fait, une divergence entre le resultat obtenu et ce que I'on imaginait obtenir peut 
passer plus ou moins inapercue : parexemple, une mauvaise gestion des espaces Wanes (espaces, tabulations, 
sauts de lignes) estsans importance pour la generation d'un fichier HTML, mais plus problematique pour celle 
d'un fichier RTF. Neanmoins, comme le comportementdu processeur XSLT est bien sur deterministe, toutfinit 
par s'expliquer, meme si c'est parfois un peu ardu. 

L'ecriture de feuilles de style par analogie et recopie de feui I les de style existantes, sans 
comprehension reel I e du fonctionnement sous-jacent, est naturellement possible, mais 
cela reste limite a des feuilles de style simples, basees sur des structures simples et en 
nombre limite, qui finissent par devenir familieres. 
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Le but decette section estdefournir une representation conceptuelledu model e detrai- 
tement d'un moteur XSLT. Bien que conceptuelle, cette representation est conforme au 
standard W3C, mais ce n'est qu'une representation : rien n'oblige (mais rien n'interdit 
non plus) les auteurs de processeurs XSLT a respecter a la lettre cette description dans 
leur implementation ; il suffit qu'i Is la respectentdansleprincipe, du moment que globa- 
lement, leur processeur fonctionne comme nous allons I'expliquer maintenant. 

Construction - serialisation 

L e processeur X SLT opere sur un arbre XML, construit au lancement du processeur par 
un parseur XM L, a partir d'un fichier XML. Ce processus s'appelle la construction de 
I'arbre; le processus inverse, qui permetl'obtention d'un fichier XM L a partir d'un arbre 
XM L, s'appelle la serialisation (voir figure 3-2). 



Figure 3-2 

Construction - 
Serialisation. 



Document XML 

<Concert> 

<Date>J eudi 17 J anvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 
<lnterpretes> 
<lnterprete> 
<Nom>J onathan Dunford <VNom> 
<lnstrument> Basse de viole </lnstrument> 
</lnterprete> 
<lnterprete> 
<Nom> Silvia Abramowicz </Nom> 
<lnstrument> Basse de viole </lnstrument> 
</lnterprete> 
</lnterpretes> 
</Concert> 



Construction 



I root 
Concert 
Lieu 

Chapelle 



Interpretes 



Interprete Interprete 

Ursules # % 

Nom Instrument Nom Instrument 
• • • • 

Jonathan Basse Silvia Basse 

Dunford de viole Abramowicz de viole 

Arbre XML du document 
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Ces deux representations document/arbre sont equivalentes, de sorte que toute operation 
sur I'arbre XML peut se transposer en une operation equivalente sur le document, et 
reciproquement. 

Les trois phases du processus complet 

Le processeurXSLT operesur I'arbreXML du document, appele arbre source, dontles 
elements sont des na?uds source. La transformation consiste a produire un nouvel arbre 
XML, appele arbre resultat. 

La serialisation decet arbre resultat produi tun document resultat qui peutetreun docu- 
ment XML, un document H TM L 4 ou XHTML, voire un simple textenon balise. 

Le processus complet est done un enchainement de trois operations : construction, trans- 
formation, serialisation (voir figure 3-3). 

Specification d'une transformation 

Une transformation XSLT est une suite d'operations elementaires sur un arbre XML, 
produisant un nouvel arbre XML. Une transformation XSLT peut done etre specified 
d'une facon tres naturelle et directe en termes d'operations sur un arbre. Mais etant 
donne I 'equivalence des representations arbre/document, il est egalement tout a fait pos- 
sible de la specifier en termes d'operations sur un document. 

Par ailleurs, le processeur X SLT n'effectuejamais de modification sur I 'arbre source ori- 
ginal : il secontentedeconstruireun nouvel arbre, de sorte que les seules operations ele- 
mental res utiles sont eel les qui consistent a greffer un nouveau morceau d'arbre a I 'arbre 
en cours de construction. Transposes a la representation par document, ces operations 
de greffes se reduisent a des concatenations de fragments de documents ou d'inclusions 
d'un fragment de document dans un autre. 

Note 

La concatenation de deux documents donnes estun nouveau document, obtenu en les mettant bout a bout dans 
I'ordreouilssontdonnes. 

Oril setrouve que d'un strict point devue redactionnel, il estbeaucoup plus simple de 
s'exprimer en termes de manipulation de document qu'en terme de construction d'arbre 
(e'est I 'inverse en programmation, ouil estbeaucoup pi us facile d'exprimer une transfor- 
mation d'arbre qu'une manipulation de document). C 'est pourquoi dans toute la suite, 
nous avons del ib<?r<?ment fait le choix d'exprimer les effets des transformations et des ins- 
tructions XSLT en termes de construction de documents a partir de fragments de docu- 
ments, et non en termes de construction d'arbres a partir de sous-arbres. 
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Modele de traitement 

Nousallonsmaintenantvoirun resume synoptiquedu modele de traitement d'un proces- 
ses X S LT, qui sera decl i ne en pi usi eurs etapes. C haque etape fait reference a I a sui vante, 
sauf la derniere qui peuteventuellementrevenir recursivement en arriere. 

Ce resume synoptique est assez general, car il ne rentre pas dans le detail de I'effet de 
chaque instruction XSLT. II secontentededecrirelemecanisme; mais plus loin (Les ins- 
tructions de transformation, page 127), nous verrons dans le detail chaque instruction 
importante deX SLT, et nous aurons I 'occasion de preciser finement le deroulement de ce 
modele de traitement pour chacune de ces instructions. 

Traitement du document XML source 

Au depart du traitement, une liste de nceuds source initiale est constitute, ne contenant 
que la racinede I'arbreXM L du document a traiter (figure 3-4). L e traitement du docu- 
ment consiste a traiter la liste de nceuds source initiale. 



Figure 3-4 

Traitement du 
document XML 


^^fh c &^po E ^' 




IIih?/j:i\t:t 


source. 


<En S emb l e>.,Adeuxvioles« g ales..<,Ensemble> 




Su*,.^ 




^Compositeurs* 




!:S!I™I!Z"r 2002, 




Document XML a traiter 






froot 




Rognom ^ 






Document resultat 




l # l 


A 




• •• •• 








• i 








Arbre XML du documents traiter 








{> 








Liste a traiter 




Traitement 






root 
















• 
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L e document final obtenu lors de ce traitement est I e document resultant du traitement de 
cette liste. 

Traitement d'une liste de noeuds source 

Le traitement d'une liste de noeuds source consiste a traiter separement chaque nceud 
source dans I'ordre ou il apparait dans la liste (figure 3-5), ce qui produit en resultat 
autantde fragments de documents qu'i I y a de noeuds source a traiter. 
L e document resultat du traitement de la liste est la concatenation des fragments de docu- 
ments obtenus separement. 



Traitement 
(l)+(2)+...+(n)+(n+l) 



Fragment de document 
--► resultat du traitement de la 
liste de noeuds 



Liste de noeuds a traiter 



Nceud 1 Nceud 2 Nceud n 
• • • 



T T T 

FD1-FD2 — FDn 



Fragments de documents 



Figure 3-5 

Traitement d'une liste den. 



Concatenation 
(n+1) 




uds source 



Traitement d'un nceud source membre d'une liste de nceuds source 

Le traitement d'un nceud source consiste a rechercher, parmi I 'ensemble des regies XSLT 
definiesdans le programme XSLT, celle dont le motif correspond au nceud traite, puis a 
appliquer cette regie, relativementaun nceud courant qui est le nceud traite, eta une liste 
courantequi est I a liste de nceuds source. 

• Si aucune regie n'est trouvee, une regie par defaut, possedant un modele par defaut, 
est appliquee. 

• Si plusieurs regies sonttrouvees, un algorithme de calcul depriorite permet normal e- 
ment d'en selectionner une et une seule (sinon le programme X SLT est incorrect). 
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L 'application de cette regie (relativement a son nceud courant et a sa liste courante), 
consiste a instancier le modele de transformation associe (relativement au meme nceud 
courant et a la meme liste courante), ce qui produit un fragment de document qui est le 
resultat du traitement du nceud source (figure 3-6). 



• • • • 

t * 

Liste contexte 




instanciation 



--► FD 

Fragment de document 



Figure 3-6 

Traitement d 



Remarque 

L'experience montre que la liste courante intervient assez rarementdans I'application de cette regie :on pourra 
done, en premiere lecture, ignorerson existence, etfaire comme s'il n'en n'etaitpas question. 



Nceud courant - Nceud contexte 

II est souvent question, en XSLT, de nceud courant etde nceud contexte. II peutetre tentantde confondre ces 
deux notions, d'autantplus que la plupartdu temps, nceud courant et nceud contexte designent le meme nceud. 
Neanmoins ce sontdeux notions differentes. 

La notion de nceud contexte intervient dans revaluation d'une expression XPath : une expression estevaluee 
relativement a un nceud contexte. 

La notion de nceud courant intervient dans I'instanciation d'un modele de transformation : un modele est instan- 
ce relativement a un nceud courant. 
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Or, dans ce processus d'instanciation, il est frequent qu'une expression XPath soit a evaluer : son evaluation se 
faitalors relativement a un nceud contexte qui estle nceud courant(ce qui explique pourquoi il peutetre tentant 
de confondre nceud contexte et nceud courant) ; mais si cette expression contient un predicat filtrantun node-set 
aplusieurs elements, le predicat sera evalue pourchacun de ses elements, qui seronttemporairement eta tour 
de role le nceud contexte de revaluation, alors que le noeud courant, lui ne change pas (ce qui explique pourquoi 
il ne faut pas confondre nceud contexte et nceud courant). 

En resume, pour ne pas se tromper, mieux vauttoujours parler de nceud courant pour un modele de transforma- 
tion etde nceud contexte pourune expression XPath. 

En deuxieme lecture, on pourra se reporter a la Remarque, page 191, qui detaille un peu plus precisement le 
processus devaluation d'un predicat, 

Instanciation d'un modele de transformation relativement a un noeud courant 
etune liste courante 

L'instanciation d'un modele de transformation consiste a obtenir un fragment de docu- 
ment a parti r du modele. Pour cef aire, tout ce qui est texte brut ou texteXM L en dehors 
du domaine nominal deXSLT (generalementdesigne par leprefixe "xsi :") est conserve 
tel quel lors de l'instanciation. Tout le reste consiste en des elements XSLT (<xsi:xxx> 
. . .</xsi :xxx>) qui sont remplaces par leur valeur, qui peut dependre du nceud courant, 
et meme parfois de la liste courante (par exemple lorsque I'une de ces valeurs est la 
valeur numeriquedu numero d'ordredu nceud dans sa liste) ; s'ilsn'ont pas de valeur, ils 
sont remplaces par rien (c'est-a-dire sont supprimes : rien est la valeur de remplace- 
ment). 

Instruction - Execution dune instruction 

Dans un modele de transformation, un element XSLT de la forme <xsi:xxx> ... </xsi :xxx> s'appelle une 
instruction. Lors de l'instanciation d'un modele de transformation, ses instructions sont executees. L'execution 
d'une instruction consiste a la remplacer par sa valeur, dans le fragment de document resultat produit par 
l'instanciation du modele de transformation. On peut done parler aussi d'instanciation d'une instruction. 
L'ordre temporel d'instanciation des instructions n'est pas forcement I'ordre sequentiel de leur apparition dans le 
modele ; d'ailleurs on pourrait tres bien imaginer qu'elles soient executees dans un ordre aleatoire (ou bien 
toutes en meme temps, sur un ordinateur multi-processeurs). Si a ce stade, cela vous para it incroyable, reportez 
vous a la figure 3-7, ou I'on voitclairementque chaque instruction estresponsable de la creation d'un boutde 
texte qui vient se mettre a sa place dans le fragment de document resultat : peu importe dans quel ordre tempo- 
rel les petits bouts de texte sontinseres dans le fragment de document resultat, du moment que I'ordre spatial 
dans lequel ils apparaissentrespecte I'ordre spatial des instructions dans le modele. 

L'evaluationde I'une des deUX instructions XSLT <xsl :apply-templates> OU <xsl :for- 

each> (et ce sont les deux seules) produit une nouvelle liste de nceuds source ; cette liste 
est alors recursivement traitee : comme toute autre liste de nceuds source, el I e subit le 
traitement standard d'une liste (voir Traitement d'une liste de nceuds source, page 88), et 
la valeur de instruction <xsi :appiy-tempiates> ou <xsi :for-each> est alors egale au 
fragment de document obtenu en tant que resultat du traitement de cette liste (figure 3-7). 
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Modele 



Texte ordinaire 



<xsl:xxx> 

<xsl:apply-templates/> 



T 



FD1-FD2 — FDn- 



Fragments de documents 



Figure 3-7 

I nstanciation d'un modele de transformatior 



Fragment de 
document res u I tat 



Liste de noeuds a trailer 



Nceud 1 Nceud 2 Nceud n 



Texte ordinaire 



FD1 


FD2 




FDn 



Motifs (patterns) 

U n motif est une expression qui, evaluee par rapport a un certain nceud contexte, designe 
un certain ensemble denceudsde I ' arbreX M L d'un document. 

Rappelons que le motif est la valeur de I'attribut match dans la definition d'une regie 
XSLT, et que cet attribut doit representer une expression X Path (verifiant une contrainte 
particuliere qui sera explicitee un peu plus loin). 
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Donnons tout de suite un exemple : 

|<xsl : tempi ate match=" child: : Theatre/child: :*"> 
<!-- modele de transformation --> 
<!-- fin du modele de transformation --> 
</xsl :template> 

Cet exemple s'applique a ce fichier XML: 

<?xml version="1.0" encoding="UTF-8"?> 

<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 
</Saison> 

L'expression child: :Theatre/chiid: :* veut dire « tous les elements X M L, qui sontdes 
fils de I'element Theatre, qui est un fils de». Ce qui ne veut pas dire grand-chose, la 
phrase s'interrompant brutal ement sans qu'on sache la fin de I'histoire. En fait, le motif 
nepeutrien dire de plus, etlerenseignementqui nous manque, c'estlenceud contexte. 

II nefaut done jamais oublierqu'un motif a base dechemin de localisation relatif, e'est- 
a-dire ne commencant pas par un «/ » (voir Chemins de localisation, page 62), ne peut 
etre evalue que par rapport a un noeud contexte donne. Dans notre cas, si I 'on prend le 
noeud <saison> comme noeud contexte, on peut alorsevaluercompletementle motif, qui 
designe I 'ensemble des elements qui sontdes fils d'un element <Theatre>, qui estun fils 
d'un element <saison> (voir figure 3-8). 

Le meme motif peut tres bien donner un ensemble vide, si on I 'evalue avec un autre 
noeud contexte. Ce sera le cas, par exemple, si I'on prend I'un des deux noeuds<Theatre> 
comme noeud contexte, car i I n'existeaucun element qui soit fils d'un element <Theatre> 
lui-meme fils d'un element <Theatre> (voir figure 3-9). 

Concordance de motifs 

Un noeud N de I'arbre XML etant donne, et un certain noeud contexte C etant ensuite 
choisi, si devaluation du motif par rapport au noeud contexte C donne un ensemble qui 
contient N , alorsonditqu'il y a concordance du motif avec I e noeud N (voir figure 3-10). 
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Figure 3-8 

Evaluation d'un 
motif par rapport 
a un na?ud context. 



root 9 

Saison lr[ 



J Nceud contexte I 

Motif 

child::Theatre/child:: 



I Theatre • • Theatre 

• ••• ••• < 



Figure 3-9 

Evaluation du meme 
motif par rapport 
a un autre n<eud 
contexte. 



root 

Saison L 
Concert 



r --J Nceud contexte 
Motif 



child::Theatre/child:: 



root a 

Saison L^ 



jnterc y 
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Figure 3-10 

Concordance de motif. 
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La chose a remarquer ici, est que contrairement a ce que Ton pourrait imaginer, la 
concordance entre un nceud N et un motif est obtenue des lors que I'ensemble de nceuds 
determine par devaluation du motif contientN : il n'est pas necessaire que cet ensemble 
se reduise au seul element N . 

Recherche de la concordance de motifs (pattern matching) 

Nous venons devoir a quelle condition il y a concordance entre un nceud N et un motif, 
un nceud contexte C etant donne. 

Nous allons maintenant voir comment le moteur XSLT effectue la recherche de concor- 
dance de motif, ou pattern matching. 

Le probleme est que dans ce processus, le nceud contexte C n'est plus donne : le but est 
alors precisement d'en trouver un. 

Ce qui est donne, maintenant, c'est le motif et le nceud N ; charge au moteur XSLT de 
determiner si I e motif concordeavec ce nceud N. 

II peut prendre un nceud C au hasard dans I'arbreXM L, et I'utiliser comme nceud con- 
texte dans I 'evaluation du motif ; si cela donne la concordance du motif avec le nceud N 
en coursd'examen, c'est gagne, il a la reponse. Maissinon, c'est touj ours I 'incertitude: 
peut-etre qu'en choisissant un autre nceud C on aurait la concordance, mais peut-etre 
qu'il n'existe aucun nceud dans I'arbreXML, qui pris comme nceud contexte, donne la 
concordance... 
Comment savoir? 

U ne premiere idee, evidente, consisterait a effectuer le test de concordance en explorant 
I'un apres I 'autre tousles nceuds de I 'arbre, eten prenantachaquefoislenceud courant 
comme nceud contexte pour evaluer I e motif : desquel'onatrouveun nceud qui donne la 
concordance, on peut arreter. 

Le probleme est que s'il n'y pas concordance, on ne le sait qu'apres avoir teste infruc- 
tueusement chaque nceud de I'arbre ! Et meme s'il y a concordance du motif avec le 
nceud N, on aura probablement commence la serie detests avec des nceuds contexte tres 
eloignes du nceud N, avec unefaible probability d'obtenir la concordance, a moins que le 
motif soit vraiment tres bizarre et complique, mettant en jeu des relations de parente tres 
eloignees entre I e nceud N etle nceud contexte qu'il fall ait trouver... 

En fait, tout le probleme est la : pourquoi ecriredes motifs tres bizarres etcompliques? 
II ne f aut pas oubl i er que I e but, dans I'ecriture d'un motif, estsimplementdedesignerun 
certain nceud, ou une famille de nceuds, sur lesquels on veut qu'une certaine regie 
s'applique. 

Dans ces conditions, entre deux motifs qui pourraient egalement convenir, un simple et 
direct et un qui passe par le cousin de I'oncle du fils du frere, autant prendre le simple 
et direct. 
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D'oii I'idee de restreindre a priori la region de I'arbre dans laquelle la recherche sera 
effectuee, ce qui bien sur limitera le motif a des relations de parente compatibles avec 
cette region. 

Or, clairement, la region la plus favorable pour lancer une recherche a parti rd'un nceud 
donne est celle qui est constitute des ancetres de ce noeud. En effet, la remontee vers un 
parent ne laisse jamais aucun choix, alors que la descente vers un enfant donne autant de 
choix possibles qu'il y a d'enfants : la remontee vers les ancetres s'apparente au simple 
parcours d'une liste lineaire, alors que la descente vers les enfants reste un processus 
eminemment arborescent et recursif. 

Si maintenant on veut que la recherche de concordance entre un motif et un nceud N 
donne ait une chance d'aboutir, alors qu'on limite a priori la recherche d'un nceud 
contexte convenable aux ancetres de N , il est imperatif que le motif ne fasse pas inter- 
vene d'autre axe de localisation que child::. 

D'ou la regie: 

Contrainte des ancetres 

Un motif ne peutmentionner aucun axe de localisation, sauf child::. On verra (Syntaxe et contrainte pour un 
motif XSLT, page 98) que Ton peutquand meme relaxer un peu cette contrainte, car il y a des axes (comme 

attribute:: ou namespace: :) qui ne font pas de mal. 

Examinons cela sur un exemple (figure 3-11) : 



Motif 

| child::a/child::b/child::c/child::d | 



• ©"»• t 
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Figure 3-11 

Recherche de concordance. 
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Cet exemple montre un arbre XML avec deux nceuds <d> et leurs ancetres communs <t>>, 
<c>, <a>. On suppose que I 'un desdeux nceuds <d> (en grisesur la figure) estlenceud que 
I 'on veut tester par rapport au motif suivant(exprimeen syntaxelongue) : 

child: :a/child: :b/child: :c/child: :d 

Puisque dans le processus de recherche de concordance de motif, on decide de se limiter 

aux nceuds ancetres du nceud test, seuls les nceuds notes (1), (2), (3), (4) etc. (jusqu'a 

la racine de I'arbre) vont etre successivement choisis comme nceud contexte. En (1), 
I 'evaluation du motif va renvoyerun ensemble de nceuds (node-set) vide, carle nceud <c> 
n'aaucun enfant <a>. On refaitevidemmentlememe constat auxetapes (2) et (3). En (4), 
I 'evaluation du motif renvoie un ensemble de nceuds constitue des deux elements <d> ; 
cet ensemble contient le nceud test: la concordance est done etablie, et la recherche 
s'arrete. 

M ais maintenant imaginons qu'un motif puisse mentionner des axes de localisation quel- 
conques, et pas seulement child: :, et que Ton puisse ecri re par exemple: 

chi ld::a/fol lowing: :b/child::c/child::d 

Arrives a I'etape (2), nous ne pourrions plus nous permettre de remonter « betement» 
vers I'ancetre suivant, puisqu'a coup sur, nous irions a I'echec ; il nous faudrait aller 
explorer certains des freres, oncles et neveux de <t>> (voir figure 2-10 a la section Repre- 
sentation graphique, page 50), et pour chacun d'eux remonter sa lignee d'ancetres. 

Ayantvu I'inteYetqu'il peuty avoir (en termed 'efficacite) a limiter a priori la recherche 
de concordance de motifs a la seule lignee d'ancetres du nceud test, il faut maintenant en 
examiner les consequences sur le pouvoir expressif des motifs. 

M ais qu'est-ce que le pouvoir expressif d'un motif ? Est-ce sa capacite a ratisser large, 
ou au contraireadiscriminerfinement? 

II n'y a aucun doutequee'estsa capacite a discriminer finement; un exemple de motif 
ne discriminant pas grand-chose serait child: modeo : un tel motif concorde avec 

n'importe quel nceud de type element node, comment node, processing instruction 

node, ou text node (voir Modele arborescent d'un document XML vu par XPath, 
page 30). 

Autant dire que si on equipe une regie d'un tel motif, la regie s'appliquera partout ou 
presquedans le document XML ; il n'y a guereque la racine (qui est fillede rien 1 ), les 
attributs et les domaines nominaux qui ne seront pas concerned par cette regie. 

On voitdonc que le motif le plus « ramasse-tout » que Ton puisse ecrire est compatible 
avec la contrainte des ancetres. 

Done, si on avaitdu souci a sefairesur une diminution du pouvoir expressif d'un motif, 
a cause de I 'introduction de la contrainte des ancetres, ce serait pi utotducoted'une dimi- 
nution de pouvoir discriminant qu'il faudrait regarder. 

Let comme telle, nerepond jamais quand on la traite de « child : : » 
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M ais en fait, il n'y a pas de probleme : meme s'il verifie la contrainte des ancetres, un 
motif peut rester tres di scri mi nant. 

Reprenonsl'exempledeja vu pour i 1 1 ustrer lepropos : 

<?xml version="1.0" encoding="UTF-8"?> 

<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 
<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 
</Saison> 

Prenons le motif Heure : il n'est pas tres discriminant, car trois elements differents 
concordent avec ce motif. M ais le motif concert/Date/Heure I'est beaucoup plus : un 
seul element du document XM L concordeavec ce motif. II estvrai quec'estparcequ'il 
n'y a qu'un seul concert dans le fichier, et que le motif Theatre/Date/Heure pourtant 
construit de la meme facon, est un peu moins discriminant, avec deux elements concor- 
dats. 

Mais rien n'empeche, s'il lefaut, de renforcer la discrimination en faisant intervenir un 
predicat. Un predicat, present dans I 'expression d'un motif, peut etre aussi complexe 
qu'on le veut, car sa complexity n'a aucune influence sur la localisation d'un noeud 
contexte adequat pour la recherche de concordance, localisation qui seratoujours limitee 
aux ancetres du noeud test. 

Le motif Theatre/Date/Heure evalue sur le noeud contexte <saison> donne en resultat 
un ensemble de deux nceuds : le noeud <Heure> 2iH </Heure> et le noeud <Heure>2iH30 
</Heure>. Supposons que I 'on veuille trouver un motif qui designeuniquementl'unede 
ces deux heures ; supposons de plus que I'heure qui nous interesse soit celle du mer- 
credi ; on peut alors exprimer que c'est une <Heure> enfant d'une <Date> dont le texte 
(i.e. child: :texto) est une chaine qui contient « Mercredi », cette <Date> etant elle- 
meme enfant de <Theatre>. 

Cequi donne le motif : 

Theatre/Date[contains(child::text(), "Mercredi ")]/Heure 

On voit done qu'il n'y a pas de souci a se faire sur les capacites discriminantes des 
motifs, meme s'ils respectent la contrainte des ancetres. 
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Syntaxe et contrainte pour un motif XSLT 

Le motif, ou pattern, fourni en tant que valeur de I ' attri but match, s'exprime sous la 
forme d'une expression X Path de type Pattern LocationPath. 

I <xsl template match=" .. .Pattern LocationPath. .. "> 
<!-- modele de transformation --> 
<!-- fin du modele de transformation --> 
</xsl :template> 

Un Pattern LocationPath estun ensemble decheminsde localisation separes par des "|" 
(qui veulent dire « ou ») ; lesdifferentesetapesdechacundecescheminsde localisation 
doiventetreconstruites uniquementsur lesaxes child:: ou attribute::, a I'exclusion 
detouslesautresaxes. 

En consequence, les abreviations "." et -.." sont interdites dans un Pattern Loca- 
tionPath : "./True" n'est pas autorise, puisque e'est equivalent a "seif::nodeo/ 
child: :Truc", et que "self: :" est interdit; de meme, ". ./True" est interdit a cause de 

I 'equivalence avec "parent: :node()/ch1 Id: :Truc". 

Bien que I'axe "descendant-or-seif :: " soit done a ce titre interdit de sejour dans 
I 'expression d'un motif, la version abregeede vdescendant-or-seif : :node( )/" sous la 
forme "//" est tout de meme autorisee en tant que separateurd'etapes, a la place du "/". 
On remarquera que cette tolerance est compatible avec la contrainte des ancetres. 
Parcontre, dansun predicat, aucun type d'axede localisation n'est interdit. 

Notons pour finir que I'emploi de parentheses (autres que celles qui servent a certains 
determinants, comme texto, par exemple) est interdit dans un Pattern LocationPath, 
sauf bien sur dans les eventuels predicats. 

Exemples de motifs 

Nous allons maintenant voir quelques exemples de motifs (Pattern LocationPath), avec 
ou sans predicats. 

Remarque 

Donnerdes exemples de motifs n'aurait pas beaucoup de sens si on ne pouvaitrien faire d'autre d'un motif que 
de I'evaluer : il faudrait alors donnerachaquefois un document XML, un nceud contexte, et un nceud test. 
Mais au lieu de cherchera evaluer un motif, on peutse contenterde chercheraevaluerson pouvoir discriminant, 
etde voir ce qu'il discrimine, dans I'absolu, en dehors de toute donnee XML. 

I child: :cha pit re/child: :sect ion/child: :paragraphe 
Forme courte : 
chapit re/section /pa rag raphe 

concorde avec tous les nceuds de I'arbre XML qui sont des <paragraphe> enfants de 
<section> elles-memes enfants de <chapitre> enfant du nceud contexte (quel qu'il soit). 
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child: :chapitre/descendant-or-self: :node( ) /child: :paragraphe 



Concorde avec tous les nceuds d'un arbre XML qui sont des <paragraphe> enfants de 
nceuds qui sont des descendants (au sens large) de <chapitre> enfant du nceud contexte 
(quel qu'il soit). 



concorde avec tous les nceuds d'un arbre XML qui sont soit des <annexe>, soit des 

<section> elleS-ITIemeS enfantS de <chapitre>. 
child: : pa ragraphe/ attribute: :alignement 

Forme courte : 
paragraphe/@alignement 

concorde avec tous les nceuds aiignement d'un arbre XML qui sont des attributs de 
<paragraphe> enfant du nceud contexte (quel qu'il soit). 



concorde avec tous les nceuds de type processing-instruction d'un arbre XML qui 

SOnt des enfantS de <paragraphe>. 

chapitre/section/paragraphe[@alignement = "centre"] 

concorde avec tous les nceuds d'un arbre XML qui sont des <paragraphe> enfants de 
<section> elles-memes enfants de <cnapitre>, a condition que les <paragrapne> pos- 

Sedentun attri but aiignement egal a "centre". 

child: : chapitre [fol 1 owing- sibling: : annexe] /descendant -or- self: :node( )/ 
child: :paragraphe 

Forme courte : 
| chapitre[following-sibling: :annexe]//paragraphe 

concorde avec tous les nceuds d'un arbre XML qui sont des <paragraphe> descendants 
de <cnapitre>, a condition que ces chapitres soient suivis par une <annexe> au meme 
niveau hierarchique. Cette traduction estun peu libre, maisellerefletebien lasemantique 
decequ'on veutexprimer : on imagine un livreconstituede parties, elles-memes consti- 
tutes de chapitres qui se suivent, sur le meme plan hierarchique, le dernier chapitre d'une 
partie pouvant etre en fait une annexe (facultative). Pour un chapitre donne, les chapitres 
qui suivent (dans la meme partie) sont situes sur I 'axe de localisation foil owing- 
sibling, de SOrte que I'expression child: :chap1tre[follow1ng-s1bl1ng::annexe] 
denote un ensemble de chapitres qui tous font partie d'une serie termi nee par une annexe 
(au sein de la meme partie). Une regie possedant ce motif s'appliquera en definitive a 
tous les paragraphes d'une serie de chapitres d'une meme partie terminee par une 
annexe. Notons pour finir que rien, dans cette expression XPath, n'imposequ'uneeven- 
tuelle annexe soit le dernier element d'une serie de chapitres ; on pourrait tres bien avoir 
une annexe en plein milieu d'une partie, avec des chapitres avant, et des chapitres apres. 
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Si c'etait le cas, seuls les chapitres situes avant pourraient concorder avec ce motif ; mais 
en pratique, il n'est pas courantdevoi rune annexe tronerau milieu de chapitres. 



child::chapitre[position() = lastO] | child:: 



Forme courte : 
chapitre[last()] | i 



concorde avec tous les noeuds de I'arbre XML qui sont des <annexe> ou bien des 
<chapitre>, a condition que ces chapitres soient en derniere position surl'axede locali- 
sation child::. Ensomme, si I'onreprend les explications du precedent exemple, on voit 
que ce motif va concorder avec le dernier chapitre de chaque parti e, que ce chapitre soit 
un vrai chapitre ou qu'il soit en fait une annexe. 
Pour lafonction lasto, revoir la section Contexte devaluation d'un pr<?dicat, page 57. 

Les motifs sont sensibles aux restrictions lexicales imposees par la notion d'attribut en 
XML. Par exemple, lecheminXPath chapitre/section[ positiono < 3 ] est correct. 

Pourtantil n'est pas possible d'enfaireun motif a cause du caractere« < » qui estinterdit 
danslachainedecaracteresformantlavaleurd'un attribut. II n'y amalheureusementpas 
d'autre solution que d'ecrire quelque chose du genre : 

<xsl : tempi ate select="chapitre/section[ positionO < 3 ]"> 

cequi n'arrangeguerela lisibilitede la chose. 

Prio rites entre regies 

Algorithme de calcul des priorites par defaut 

II peutarriver, au coursdu processus detraitement (voir P rincipe de fonctionnement d'un 
processeur XSLT, page 83), que plusieurs regies soient el igibles : pour chacune d'entre 
elles, le motif concorde avec lenceud en cours detraitement. Un algorithme de calcul de 
priorite par defaut est alors mis en ceuvre pour en selectionner une ; cet algorithme est 
assez complexedans le detail, maisgrosso-modo, on peut dire qu'entre deux regies dont 
I 'une est plus specifique que I 'autre, c'est a la plus specifique que la priorite la pi us forte 
est aff ectee. 

Un cas tres courant ou cette notion de« plus specifique » s'appliquedefacon evidente, 
estcelui d'une concurrence entre deux regies dont I'une utilise un joker ("*-) : 

<xsl :template match="Heure"> 

</xsl :template> 

<xsl :template match="*"> 

</xsl :template>> 

En reprenantlefichierXML dejavu en Motifs (patterns), page 91 : 

<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 



<Concert> <Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 
<Theatre> <Organisation> Masques et Lyres </Organisation> 

<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 
<Theatre> <Organisation> Masques et Lyres </Organisation> 

<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 
</Saison> 

on voitquesur n'importequel noeud <Heure> decefichier, lesdeux regies ci-dessussont 
egalementappli cables. Neanmoins, "*" etantmoinsspecifiqueque "Heure", c'estla pre- 
miere regie qui va I'emporter. 

Forgage de la priorite 

L'algorithme de calcul des priori tes par defaut etant assez fasti dieux a suivre, il est prefe- 
rable de nepas s'y confronter, d'autantquec'esttoujours possible. En effet, il existe un 
attri but priori ty qui permet d'affecter une priorite a une regie, ce qui permet de forcer la 
decision dans les casou I'on sent que I'on nemaitrise plus tresbience qui va se passer : 

<xsl template match='Theatre//Heure' priority="2"> 

</xsl :template> 

<xsl : tempi ate match='Heure' priority="l"> 

</xsl :template> 

L'heure d'un concert sera prise en compte par la deuxieme regie, car pour un concert, le 
motif de la premiere ne concorde pas : pas d'ambiguite. Par contre I 'heure d'une piece de 
theatre peut etre prise en compte par les deux regies ; la priorite de 2 sur la premiere lui 
permet de I'emporter. 

A chaquefoisqu'un programmeXSLT contient des regies simultanement eligibles, il est 
detresloin preferable d'imposer les priorites que I'on souhaite, plutotquedesehasarder 
a finasser sur les priorites par defaut ou de tester ce que eel a donne avec tel ou tel proces- 
ses parti culier, et d'en tirer des conclusions qui ne seront peut-etre pas... concluantes. 

Resume 

N ous avons vu la forme generale d'une regie X SLT (voi r Forme d 'une regie XSLT, page 79) : 

. motif (pattern) ..."> 



melange de texte et d'instructions XSLT du genre 
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<!-- fin du modele de transformation --> 
</xsl :template> 

Puis nousavons vu I e modele detraitement, qui expliquece que fait leprocesseur XSLT, 
et comment les regies X SLT interviennent dans ce processus. 

Enfin nousavonsvu la notion de motif, etde concordance de motif. 

1 1 reste done encore avoir les di fferentes i nstructi ons X SLT, i ntervenant dans I e corps des 
model es de transformation. 

Mais avantcela, nous all ons maintenant detainer les deux i nstructi ons fondamentales de 
XSLT, a savoir xsi:vaiue-of et xsi :appiy-tempiates. Ces deux instructions sont 
importantes a comprendre en profondeur, parce qu'elles se completent tellement qu'on 
peut direqu'a elles deux, ellesforment le noyau dur des possibilitesde transformations 
real i sables en XSLT. 



Note 

Certains auteurs parlentd'extraction individuelle (pull processing) pour <xsl:value-of>etde distribution selective 
(push processing) pour<xsl:apply-templates>, par reference a certains langages specialises dans le traitement 
et la manipulation de chaines de caracteres, comme awk sous Unix. Meme si I'on peut trouver que cette termi- 
nologie ne facilite pas vraimentla comprehension de la chose, il est tout de meme remarquable de voir que ce 
sont ces deux mots si complementaires (push et pull) qui ontprecisementetechoisis pourcaracteriserla nature 
de ces deux instructions. 



Instruction xsl:value-of 

Une regie XSLT uti I isant I 'instruction xsi :vai ue-of a d'ordinaire I'alluresuivante : 



<xsl :template match="... motif (pattern 




<!-- modele de transformation --> 




melange de texte et 




d'instructions XSLT de la forme : 




<xsl :value-of select 3 "... chemir 


de 1 


<!-- fin du modele de transformatior 


-> 


</xsl :templ ate> 





Comme son nom I'indique, instruction <xsi :vaiue-of seiect=". .." /> estremplacee 
lors de I'instanciation du modele par la valeur textuelle de ce qui est designe par I'attribut 
select. II s'agitdonc de la valeur textuelle (i.e. sous forme dechainede caracteres) d'un 
node- set. 

Un node-set comportant en general plusieursnceuds source, sa valeur textuelle est defi- 
nie comme etant eel le du nceud source qui arrive en premier dans I'ordre de lecture du 



Instruction xsl:value-of 
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document. L'instruction est done finalementremplacee par la valeurtextuelle d'un noeud, 
notion qui a ete definie a la section Module arborescent d'un document XML vu par 
XPath, page 30 etsuivantes. Quant au node-set en question, il resulte del 'evaluation du 
chemin de localisation fourni commevaleur del 'attri but select. Cechemin de localisa- 
tion est calcule en prenant le noeud courant comme noeud contexte. 



Exemple 



<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

<0rganisation> Anacreon </0rganisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 
</Concert> 
<Theatre> 

<0rganisation> Masques et Lyres </0rganisation> 

<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 
<Theatre> 

<0rganisation> Masques et Lyres </0rganisation> 

<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 
</Saison> 



<?xml version=" 
<xsl :stylesheet 

xmlns:xsl = "http://' 



icoding="UTF-8"?> 

.w3.org/1999/XSL/Transform" 



<xsl:output method='text' encoding='UTF-E 



slue-of select="Sai son/Concert/Date" /> 
slue-of select="Saison/Theatre[l]/Date"/> 
slue-of select="Saison/Theatre[2]/Date"/> 



<xsl :template match='/'; 

Date Concert : <xsl : 

Date Theatre 

Date Theatre 
</xsl :template> 

</xsl:stylesheet> 

Cet exemple est d'un style assez contestable, car la regie XSLT indiquee presuppose 
qu'il y ait 1 element <concert> et 2 elements <Tneatre> dans le fichier XML traite. 
Neanmoins, il est interessant parce qu'il ne requiert que des connaissances XSLT deja 
vues, pour etre analyse et compris. 

Appliqueeau fichier sai son. xmi , cette feuille de style produit le resultat suivant : 



Au cceur du langage XSLT 



I Date Concert : Samedi 9 octobre 1999 20H30 
Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H30 

La declaration <xsi: output method='text' encoding='UTF-8'/> permet de specifier 
quel'on veutgenerer un resultat qui sera un simple document texte (encode en UTF-8), 
et non pas un document XML balise comme il se doit. Si I'on supprimait cette 
declaration, voici le resultat que I 'on obtiendrait : 

<?xml version="1.0" encoding="UTF-8"?> 

I Date Concert : Samedi 9 octobre 1999 20H30 
Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H30 

soit a peu pres la meme chose, sauf le preambule de fichier XML genere automatique- 
ment, en contradiction avec la suite du fichier qui n'a pas du tout I'aird'un fichier XML. 

Deroulement du processus de traitement sur cet exemple 

Cette section estasuivreen parallele avec la section Module de traitement, page 87. 

Constitution d'une liste ne contenantque la racine 

C'est ('initialisation du traitement ; une liste est constitute, ne contenant que la racine, 
puis le traitement general de traitement des listes est lance (voir figure 3-12). 



Figure 3-12 

Constitution d'une 
liste ne contenant 
que la racine. 




Traitement de cette liste 

Le traitement de cette liste se decompose en deux etapes : traitement de chaque nceud de 
la liste, puis concatenation des fragments de documents obtenus (voir figure 3-13). Dans 
notre cas, un seul fragment de document est produit, la concatenation se reduit done a 
une action nulle. 

Traitement du nceud 

Dans notre exemple, il n'y aqu'uneseuleregle, etson motif concorde avec le nceud cou- 
rant (c'est-a-direla racine). La regie va done s'appliquer, cequi veut dire que lemodele 
de transformation associe va etre instancie (voir figure 3-14). 



Instruction xsl:value-of 





Liste a traiter 


Traitement 
(D+(2) 




root 






Traitement 

du nceud root 

(1) 

T 







Chapitre 3 
Document resultat 



Date Concert: Samedi 9 0ctobrel999 20H30 
DateTheatre: Mardi 19 Novembre 1999 21H 
D ate Theatre : M ercredi 20 N ovembre 1999 21H 30 



Figure 3-13 

Traitement decette liste. 



(2) 

Concatenation 

(non effective pour 1 seul element) 



Programme XSLT 




D ate C oncert : <xsl :val ue-of sel ect=" Sai son/C oncert/D ate"/> 
DateTheatre : <xsl :val ue-of select="Saison/Theatre[l]/Date7> 
DateTheatre : <xsl:val ue-of select="Saison/Theatre[2]/Date"/> 



Figure 3-14 

Traitement du na»ud. 



DateConcert: Samedi 90ctobrel999 20H30 
DateTheatre : M ardi 19 Novembre 1999 21H 
DateTheatre: M ercredi 20 Novembre 1999 21H30 



Au cceur du langage XSLT 



Instantiation du modele 

Le model ede transformation estici constitue d'un melange detextesordinai res (comme 
par exemple « Date Concert : ») qui seront done recopies tels quels dans le fragment de 
document resultat, et destructions <xsi :vaiue-of>,qui seront done remplaceesparleur 
valeur dans le fragment de document resultat (voir figure 3-15). 



Fragment de 



M odele 


recopie 


document resultat 












remplace par sa valeur 










-«- Samedi 9 Octobre 1999 20H30 


^n ' 


recopie 






DateThLatre. | 


remplace par sa valeur 
recopie 








<xsl:value-of select="5aison/Theatre[l]/Date'7> I - 


-"► Mardi 19 Novembre 1999 21H 




remplace par sa valeur 








<xsl:value-of select="5aison/Theatre[2]/Date7> I - 


-*~ M ercredi 20 N ovembre 1999 21H30 





Figure 3-15 

I nstanciation du modele. 



Valeur des differents node-sets 

Node-set "Saison/Concert/Date" 

Pour devaluation de cette expression XPath, le nceud contexte est root . La valeur d'un 
node-set est eel le de son premier element dans I'ordre de lecture du document (voir I nstruc- 
tionxsl:value-of, page 102) ; ici, I e node-set, calcule a parti rdu nceud contexte root , pos- 

Sedeunseul element: <Date>Samedi 9 octobre 1999 <Heure> 20H30 </HeureX/Date>. 

La valeur de cet element est egale au texte « Samedi 9 octobre 1999 » concatene a la 
valeur de I 'element <Heure> 20H30 </Heure> (voir Na?ud de type element, page 31) qui 
elle-meme est egale au texte « 20H30 ». Ce qui donne finalement « Samedi 9 octobre 
1999 20H30». 



Node-set "Saison/Theatre[l]/Date 

Pour revaluation de cette expression X Path, le nceud contexte est root . La valeur d'un 
node- set est eel le de son premier element dans I'ordre de lecture du document (voir I nstruc- 
tion xsl:value-of, page 102) ; ici, le node-set, calcule a partirdu nceud contexte root , pos- 

Sedeun Seul element : <Date>Mardi 19 novembre 1999 <Heure> 21H </HeureX/Date>. 

La valeur de cet element est egale au texte « Mardi 19 novembre 1999 » concatene a la 



Instruction xshapply-templates 



valeur del 'element <Heure> 21H </Heure> </Date> (voir Na;ud de type element, page 31) 
qui elle-memeestegaleau texte« 21H ». Cequi donnefinalement« M ardi 19 novembre 
1999 21H ». 

Node-set "Saison/Theatre[2]/Date 

En suivantexactementlememeraisonnement, on obtient « Mercredi 20 novembre 1999 

21H30». 

Instruction xshapply-templates 

ineralement la forme 



Une regie XSLT utilisant I'instruction xsi 


:apply-templates 


a 


suivante : 






<xsl : tempi ate match="... motif (pattern) 


..."> 




<!-- modele de transformation --> 






... texte ... 






<xsl :apply-templates /> 






. . . texte . . . 






<!-- fin du modele de transformation 


--> 




</xsl:template> 







instruction <xsi :appiy-tempiates/> est remplacee par le fragment de document qui 
resulte du traitement de la liste des enfants du nceud courant. Le detail important, ici, est 
que cette liste, que nous avions deja evoquee (voir I nstanciation d 'un modele de transfor- 
mation relativementa un no>ud courant et une liste courante, page 90) est constitute des 
elements enfants du nceud courant, pris dans I 'ordre de lecture du document source. 



Exemple 



Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transforit 



<xsl:output method='text' encoding='UTF-87> 

<xsl :template match='/'> 

<xsl :apply-templates/> 
</xsl :template> 

<xsl :template match='Saison'> 

Manifestations au programme 

<xsl :apply-templates/> 

Reservations 10 jours avant la date. 
</xsl :templ ate> 



Au cceur du langage XSLT 



<xsl :template match=' Concert') 

Concert : <xsl :val ue-of select="."/> 
</xsl :template> 

<xsl:template match='Theatre'> 

Theatre : <xsl :val ue-of select="."/> 
</xsl :template> 

</xsl:stylesheet> 

Appliquee au meme fichier saison.xmi que celui vu precedemment (voir Exemple, 
page 103), cette feuille de style produit le resultat suivant : 



Concert : 

Pygmal ion 
Samedi 9 octobre 
Chapelle des Urs 



Theatre : 

Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 



Theatre : 

Aristophane 
Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 



Deroulement du processus de traitement sur cet exemple 

Cette section est a suivre en parallele avec la section M od<?le de traitement, page 87. 

Constitution d'une liste ne contenantque la racine 

C'est ^initialisation du traitement ; une liste est constitute, ne contenant que la racine, 
puis le traitement general de traitement des listes est lance (voir figure 3-16). 

Traitement de cette liste 

L e traitement de cette I istese decompose en deux etapes : traitement dechaquenceud de 
la liste, puis concatenation des fragments de documents obtenus (voir figure 3-17). Dans 
notre cas, un seul fragment de document est produit, la concatenation se reduit done a 
une action nulle. 



Instruction xshapply-templates 



Figure 3-16 

Constitution d'une 
listenecontenant 
que la racine. 




L iste a trailer 

root 



Figure 3-17 

Traitement 
decette I iste. 



Document resultat 







Traitement 
(D+(2) 


— ~ 


L iste a 


traiter 




-«" 


! root 






t SZL„ 






Traitement 

du nceud root 

(1) 




> 


< 


▼ 






M anifestations au programme 




Pygmalion 

Samedi 9 Octobre 1999 20H30 

ChapelledesUrsules 






Theatre: 

Masques et Lyres 

Mardi 19 Novembrel999 21H 

Salle des Cordeliers 

Theatre: 

M ercredi 20 Novembre 1999 21H30 
Salle des Cordeliers 


Concatenation 

(non effective pour 1 seul element) 

(2) 








Reservations 10 jours avant la date. 









Au cceur du langage XSLT 



Traitementdu nceud 

Dansnotreexemple, il n'y aqu'uneseuleregle, etson motif concorde avec le nceud cou- 
rant (c'est-a-dire la racine). La regie va done s'appliquer, ce qui veut dire que le modele 
de transformation associe va etre instancie (voir figure 3-18). 



Programme XSLT 









la premiere a e'te'plac 
pa 


r commodite 










<xsl template match='Saison'> 

M anifestations au programme 
<xsl:apply-templates/> 
Reservations 10 jours avant la date. 

</xsl:template> 










<xsl:template match='Concert'> 

Concert: <xsl:value-of select="."/> 
</xsl:template> 




root r 




concordance 


<xsl:template match=Theatre'> 

Theatre : <xsl:value-of select= 
</xsl:template> 


'"/> 






^Theatre 








<xsl:apply-templates/> 




Saison . 


„ 




Concert/ 


</xsl template> 


Instanciation 






/ 1 \Lieu 






▼ 












Figure 3-18 

Traitementdu na?ud. 



Instanciation du modele de transformation 

Le modele a instancier comportant une instruction <xsi :appiy-tempiates>, celle-ci est 
remplacee par sa valeur, resultant du traitement d'une nouvelle liste de nceuds. Cette nou- 
velle liste est constituee en rassemblant tous les nceuds enfants du nceud courant. Ici, 
comme le nceud courant est root , il n'y a qu'un seul enfant, qui est le nceud <saison> 
(voir figure 3-19). 



Instruction xshapply-templates 



M odele 



Generation d'une 

nouvelleliste 
(1) 



t 



Saison 
• 



Traitement 
du noeud 
Saison 



Fragment de 
document resultat 



Traitement 
(2) +(3) 



Concatenation 

(non effective pour 1 seul element) 

(3) 



Figure 3-19 

Instanciation du module de transformation. 



Au cceur du langage XSLT 



Traitementdu nceud <Saison> 

Le noeud <Saison> est le noeud COUrant; la regie <xs1: tempi ate match='Saison'> 

concorde avec ce noeud, el I e est done appliquee (voir figure 3-20). Son application se tra- 
duitpar I'instanciation du model ede transformation associe. 



Programme XSLT 



root p 




I 'ordre des regies etant indifferent, 
la regie se'lectionne'e a e'te' place'e en 
dernier par commodite' 
<xsl:templatematch='/ l > 

<xsl:apply-templates/> 
</xsl:template> 

<xsl:template match='Concert'> 

Concert : <xsl:value-of select=".7> 
</xsl:template> 

<xsl template match=Theatre'> 

Theatre : <xsl:value-of select="."/> 
</xsl:template> 
^ <xsl:templatematch='Saison l > 

M anifestations au programme 
<xsl:apply-templates/> 
Reservations 10 jours avant la date. 



Figure 3-20 

Traitementdu no?ud <Saison>. 



Instantiation du modele de transformation 

Le modele a instancier comporte d'une part du texte ordinaire qui est done recopie dans 
le fragment de document resultat, et d'autre part une instruction <xsi :appiy-tempi ates>. 
E I le est remplacee par sa valeur, qui resulte du traitement d'une nouvelle liste de noeuds 
comportant I 'ensemble des noeuds enfants du noeud courant, e'est-a-dire I'element 
<saison> (voir figure 3-21). 



Instruction xshapply-templates 



M odele 










recopie 




M anifestations au programme 








remplace par sa valeur 
(lf+(2)+(3)+(4)+(5) 








«sl:apply-templates/> 


















Traitement 
(2)+(3)+(4)+(5) 








recopie 






















Generat 


on d'une 







Fragment de 
document resultat 



nouvelleliste 
(1) 






Concert 
— • 



Theatre 
• 



Theatre 

•- 



Traitement 

du noeud 

Concert 

(2) 



Traitement 

du noeud 

Theatre 

(3) 



Traitement 

du noeud 

Theatre 

(4) 



Figure 3-21 

I nstanciation du modelede transformation. 



Au cceur du langage XSLT 



II y a done desormais trois traitements separes a effectuer (qui pourraient, dans I 'ideal , 
etre realises simultanement sur trois processeurs materiels differents), un pour le noeud 
<concert>, un pour le premier noeud <Theatre>, et un pour le deuxieme noeud <Theatre>. 

Premiere branche du traitement (noeud <Concert>) 

Traitementdu nceud <Concert> 

Le noeud <Concert> est le noeud COUrant; la regie <xsl template matcr^' Concerts 
concorde avec ce noeud, el I e est done appliquee (voir figure 3-22). Son application se tra- 
duitparl'instanciation du model ede transformation associe. 



Programme XSLT 



root % 




I 'ordre des regies e'tant indifferent, 
la regie sdectionne'e a ete place'e en 
dernier par commodite 
<xsl:templatematch=7'> 

<xsl:apply-templates/> 
</xsl:template> 

<xsl:template match='Saison'> 

M anifestations au programme 
<xsl:apply-templates/> 
Reservations 10 jours avant la date. 

</xsl:template> 

<xsl template match=Theatre'> 

Theatre : <xsl:value-of select="."/> 

</xsl:template> 
^ <xsl:templatematch='Concert'> 

Concert: <xsl:value-of select="."/> 



Pygmalion 

Samedi9 0ctobrel999 20H30 

C hapel I e des Ursules 



Figure 3-22 

Traitementdu na?ud <Concert>. 



Instruction xshapply-templates 



Chapitre 3 



Instanciation du modele de transformation 

Le model e de transformation contient du texte neutre (recopie dans I e fragment de docu- 
ment resultat), et une instruction <xsi :vaiue-of seiect="."/> . Cette instruction est 
remplaceeparsavaleur, surleprincipedejavu dans la section Va leu r desdiffe'rents node- 
sets, page 106. La figure 3-23 montred'unepartl'instanciationdu modele, etd'autrepart 
lesetapesdu calcul dela valeurdu node-set reduitau seul element <concert>. 



Fragment de 





M odele 




document resultat 




recopie 


-* 




E^E 








remplace par sa valeur 






-* 


Pygmalion 

Samedi9 0ctobrel999 20H30 

Chapelle des Ursules 


<xsl:value 















^- element -. 

f Concert J 



element 

1 Organisation I 1 

text 
Pygmalion 

text 


_ element element 

Date J f Lieu 

text 

Chapelle 
element Ursules 


~es~l 


valeurf <Concert>) = 

concatenation! 

valeur( <Organisation>) + 
valeurj <Date>) + 
valeurj <Lieu>) 

) 

valeur( <Organisation>) = "■'Pygmalion" 

valeurf <Date>) = 

"Samedi 9 Octobre 1999" + 
valeur( <Heure>) 

valeur( <Lieu>) ="ChapelledesUrsules" 

valeurf <Heure>) ="20H30" 


f Heure J 




Samedi 9 
Octobrel999 




Figure 3-23 

Instanciation du modele de 


r20H3ol 




transformation. 





Au cceur du langage XSLT 



Deuxieme branche du traitement (noeud <Theatre>) 

Traitementdu premier noeud <Theatre> 

Le premier noeud <Theatre> est le noeud COUrant; la regie <xsl : tempi ate match= 'Thea- 
tre '> concorde avecce noeud, elle est done appliquee (voir figure 3-24). Son application 
setraduitparl'instanciation du modele de transformation associe. 




Programme XSLT 

I 'ordre des regies plant indifferent, 
la regie s<?lectionn<?e a ete plac<?e en 
dernier par commodity? 
<xsl:templatematch=7'> 

<xsl:apply-templates/> 
</xsl:template> 

<xsl:template match='Saison'> 

M anifestations au programme 
<xsl:apply-templates/> 
Reservations 10 jours avant la date. 

</xsl:template> 

<xsl:template match='Concert'> 

Concert : <xsl:value-of select=".7> 
</xsl:template> 



-^ <xsl template match=Theatre'> 



Figure 3-24 

Traitementdu premier n 



Masques et Lyres 

Mardi 19 Novembrel999 21H 

Salle des Cordeliers 



Instanciation du modele de transformation 

Le modele de transformation contient du texte neutre (recopie dans le fragment de docu- 
ment resultat), et une instruction <xsi :vaiue-of seiect="."/> . Cette instruction est 
remplacee par sa valeur, sur le principe deja vu dans la section Valeur des differents node- 
sets, page 106. La figure 3-25 montred'unepartl'instanciationdu modele, etd'autrepart 
lesetapesdu calcul de la valeur du node-set reduitau seul element <Theatre> (le premier 
des deux). 



Instruction xshapply-templates 



M odele 



Fragment de 
document resultat 



> 



recopie 
rem place par sa valeur 











Theatre : 
















M ardi 19 Novembre 1999 21H 
Salle des Cordeliers 













^- element -^ 

f Theatre 1 

element 

f Organisation J f Date J f Lieu J 



text 

M asques et 
Lyres 


dement 

1 Heure J 


text 

Salle des 


text 






M ardi 19 
Novembre 1999 






Figure 3-25 

Instantiation du modelede 


» 1 




transformation. 





valeur( <Theatre>) = 
concatenation! 

valeur( Organisation:*) + 

valeurj <Date>) + 

valeur( <Lieu>) 
) 

valeur( <Organisation> ) = "M asques et Lyres" 

valeur( <Date>) = 

"M ardi 19 Novembre 1999" + 
valeur( <Heure>) 

valeur( <Lieu>) = "Salle des Cordeliers" 

valeur( <Heure>) ="21H" 



Troisieme branche du traitement (nceud <Theatre>) 

Traitementdu deuxieme nrjeud <Theatre> 

Le deuxieme nceud <Theatre> est le nceud courant; la meme regie <xsi :tempiate 
match=' Theatre ■> concorde avecce nceud, elleestdoncanouveau appliquee (voir figure 
3-26). Son application setraduitpar I'instanciation du modelede transformation associe. 



Au cceur du langage XSLT 



Programme XSLT 

I'ordrede 



nt indifferent, 
ar commodity 




<xsl:templatemateh=7'> 

<xsl:apply-templates/> 
</xsl:template> 

<xsl template match='Sai5on'> 

M anifestations au programme 
<xsl:apply-templates/> 
Reservations 10 jours avant la da 

</xsl:template> 

<xsl:template match='Concert'> 

Concert : <xsl:value-of select- 1 . 
</xsl:template> 
-^ <xsl:template match=Theatre'> 





T 


Aristophane 
Mercredi 20 Nc 
Salle desCorde 


vembrel999 21H30 



Figure 3-26 

Traitementdu deuxieme na>ud <The'dtre>. 



Instanciation du modele de transformation 

Le modele de transformation contient du texte neutre (recopie dans le fragment de docu- 
ment resultat), et une instruction <xsi :vaiue-of seiect="."/> . Cette instruction est 
remplacee par sa valeur, sur le principe deja vu dans la section Valeur des differents node- 
sets, page 106. La figure 3-27 montred'unepartl'instanciationdu modele, etd'autrepart 
les etapes du calcul de la valeur du node-set reduit au seul element <Theatre> (le 
deuxieme). 

Synthese de ces trois traitements independants 

Les fragments de documents obtenus lors des instanciations de modeles (figures 3-27, 
3-25, 3-23) sont concatenes (voir etape (5) de la figure 3-21), ce qui donne la forme 
definitive du document resultat, que I 'on retrouve ensuite inchange lorsqu'on remonte 
depuis la figure 3-21 jusqu'a la figure 3-17 . 



Regies pardefaut 



M odele 



Fragment de 
document resultat 



> 



rem place par sa valeur 



Salle des Cordelier 



^- element -^ 

f Theatre 1 

element 

f Organisation J f Date J f Lieu J 



text 

Aristophane 


element 

1 Heure J 


text 

Salle des 


text 






M ercredi 20 
Novembrel999 






Figure 3-27 

Instanciation du modelede 


r21H3ol 




transformation. 





valeur( <Theatre>) = 

concatenation! 

valeur( <Organisation>) + 
valeurj <Date>) + 
valeur( <Lieu>) 

) 

valeur( <Organisation> ) = "Aristophane" 

valeur( <Date>) = 

"M ercredi 20 Novembre 1999" + 
valeur( <Heure>) 

valeur( <Lieu>) = "Salle des Cordeliers" 

valeur(<Heure>)="21H30" 



Regies pardefaut 

1 1 peut arriver que lors du traitement d'un nceud, aucune regie fournie dans le programme 
X SLT ne soit applicable, car aucun motif ne concorde avec le nceud courant. Dans ce cas, 
une regie par defaut est appliquee, qui depend de la nature du nceud a traiter. 
Et comme par hasard, les regies par defaut, que nous allons maintenant voir, n'utilisent 

quelesdeUX instructions xsl :value-of etxsl :apply-templates. 



Au cceur du langage XSLT 



Regies par defaut pour la racine d'un arbre XML ou un element 

La regie par defaut instancie un fragment de document en reportant le traitement sur les 
enfants du nceud courant. 



Elles'exprimedonc ainsi 

I 



<xsl :template match='/|*'> 
<xsl :apply-templates/> 
</xsl: template) 



Remarque 

line regie par defaut n'est jamais en conflit avec une regie explicite. II ne faut pas imaginer qu'une regie par 
defaut comme celle montree ci-dessus se comporte comme si elle eta it automatiquement incorporee a la feuille 
de style par le processeur XSLT. Une regie par defaut reste interne au processeur; elle n'est activee que si 
aucune regie, dans la feuille de style, n'est applicable. Si dans votre feuille de style, vous avez une regie 
<xsi: tempi ate match='*'> ... </xsi :tempiate>, elle n'entrera jamais en conflitavec la regie pardefeut, 
car la regie par defaut sera ignoree. 
Ce qui est ditici est bien sur valable pour les autres regies par defaut decrites ci-dessous. 



Regies par defaut pour un nceud de type text ou attribute 

La regie par defaut instancie un fragment de document en prelevant la valeur du nceud 
courant. 

Elles'exprimedonc ainsi : 

|<xsl : tempi ate match='text( ) | attribute: :*'> 
<xsl:value-of select = "." /> 
</xsl: template) 

Regies par defaut pour un noeud de type comment 
ou processing-instruction 

La regie par defaut instancie un fragment de document vide. 
Elles'exprimedonc ainsi : 

|<xsl :template match='comment( ) | processing-instruction( ) '> 
</xsl: template) 



Exemples 



Nous conservons toujours le meme exemple de fichier XML a traiter; aucune regie 
explicite n'est cette fois fournie dans le programme X SLT : 



;ion="1.0" encoding="UTF-8"?> 

:xsl = "http://www.w3.org/1999/XSL/Tre 
>n = "1.0"> 



Regies par defaut 



I <xsl : output method='text' encoding='UTF-8'/> 

</xsl:stylesheet> 

Le resultat obtenu est alors le suivant : 



Chapelle des Ursule 



Salle des Cordelie 



Ce resultat s'interprete ainsi : la racinedel'arbreXM L du document est traitee; aucune 
regie ne s'applique (et pour cause), la regie par defaut 

<xsl : tempi ate match='/|*'> 
<xsl :apply-templates/> 
</xsl :template> 

est done appliquee, cequi entraineletraitementdu noeud racinedu document ( <saison>). 
A ucune regie ne s'applique a ce noeud, la regie par defaut 

<xsl : tempi ate match='/|*'> 
<xsl :apply-templates/> 
</xsl :template> 

s'applique done anouveau, cequi entraineletraitementdes nceuds<concert>, <Th<§atre>, 
<Theatre>. A ucune regie ne s'applique au noeud <concert>, la regie par defaut 

<xsl :template match='/|*'> 
<xsl :apply-templates/> 
</xsl :template> 

s'applique done a nouveau, ce qui entraine le traitement des noeuds <organisation>, 

<Date>, <Lieu>. 

A ucune regie ne s'applique au noeud <organisation>, la regie par defaut 

I 



;1 :template match='/|*'> 
<xsl :apply-templates/> 
</xsl :template> 



Au cceur du langage XSLT 



s'applique done a nouveau, ce qui entraine le traitement du nceud text enfant de 

<Organisation>. 

Aucune regie ne s'applique a ce nceud texte, la regie par defaut 

|<xsl : tempi ate match='text( ) [attribute: :*'> 
<xsl:value-of select = "." /> 
</xsl: template) 

s'applique done, cequi entraine I'instanciation du fragment de document Anacreon. 

II en va de meme pour les autres elements du document XML: tous les elements sont 
traites par la regie 

<xsl :template match=7|*'> 
<xsl :apply-templates/> 
</xsl :templ ate> 

ettous les nceuds text sont traites par la regie 

|<xsl : tempi ate match='text() | attribute: :*'> 
<xsl:value-of select = "." /> 
</xsl :templ ate> 

ce qui finit par produire un document identique au document XML original, prive de 
toutessesbalises. 

Le premier exemple que nous avons vu (voir Exemple, page 103) 
Saison.xsl 



<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" version = "1.0"> 

<xsl:output method='text' encoding='UTF-8'/> 

<xsl :template match='/'> 

Date Concert : <xsl :val ue-of select="Saison/Concert/Date"/> 
Date Theatre : <xsl :val ue-of select="Saison/Theatre[l]/Date"/> 
Date Theatre : <xsl :val ue-of select="Saison/Theatre[2]/Date"/> 

</xsl :template> 

</xsl:stylesheet> 

pourrait etre reecrit dans un style beaucoup plus correct, en utilisant les regies par 
defaut : 



<?xml version="1.0" encoding="UTF-8"? 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/19 



Regies pardefaut 



<xsl: output method='text' encoding=' ISO-8859-1 '/> 

<xsl : tempi ate match=' Concert '> 

Date Concert : <xsl :val ue-of select="Date"/> 
</xsl :template> 

<xsl : tempi ate match='Theatre'> 

Date Theatre : <xsl :val ue-of select="Date"/> 
</xsl :template> 

</xsl: stylesheet) 
et on obtiendrait a nouveau : 

Date Concert : Samedi 9 octobre 1999 20H30 
Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H3C 



Comportement inattendu d'un programme XSLT 

La presence de ces regies impli cites induisent parfois des comportements apparemment 
bizarresde la part du processeurXSLT, lorsquele source XSLT comporteuneerreur. Par 
exemple, introduisonsunefautedefrappedanslabalise<Theatre> , en oubliant I'accent 
circonflexesur le« a», commececi : 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1 '/> 

<xsl :template match='Concert'> 

Date Concert : <xsl :val ue-of select="Date"/> 
</xsl :template> 

<xsl :template match='Theatre'> 

Date Theatre : <xsl :val ue-of select="Date"/> 
</xsl :template> 

</xsl: stylesheet) 
Le resultat n'a alors plus rien a voir avec ce qu'on souhaite : 

Date Concert : Samedi 9 octobre 1999 20H30 



Au cceur du langage XSLT 



Le resultat obtenu etant plus volumineux que ce qu'on attendait, c'est done que des 
regies par defaut ont ete mises en ceuvre. 

Pour savoir exactement ce qui se passe, on peut incorporer au programme XSLT une 
regie « attrape-tout » : 

|<xsl :template match='*'> 
erreur : element non prevu : tag{ <xsl :val ue-of select="local -name( . )" /> } 
<xsl :apply-templates/> 
</xsl :template> 

local -nameo est une fonction qui renvoie le nom de I 'element fourni en argument 
(ici « . », c'est-a-direl'elementcourant). 

Le processeur X SLT applique cette regie de preference a la regie par defaut, 

<xsl :template match='/|*'> 
<xsl :apply-templates/> 
</xsl: template) 

parce qu'une regie par defaut est par definition choisie quand aucune autre, fournie expli- 
citement, neconvient. Voici alors le resultat obtenu : 

erreur : element non prevu : tag{ Saison } 
Date Concert : Samedi 9 octobre 1999 20H30 

erreur : element non prevu : tag{ Theatre } 

erreur : element non prevu : tag{ Organisation } 
Masques et Lyres 

erreur : element non prevu : tag{ Date } 

Mardi 19 novembre 1999 

erreur : element non prevu : tag{ Heure } 



erreur : element non previ 
Salle des Cordeliers 



erreur : element non prevu : tag{ Theatre } 



erreur : element non prevu : tag{ Organisation } 
Masques et Lyres 

erreur : element non prevu : tag{ Date } 

Mercredi 20 novembre 1999 

erreur : element non prevu : tag{ Heure } 
21H30 

erreur : element non prevu : tag{ Lieu } 
Salle des Cordeliers 

Tous ces messages d'erreur sont coherents avec ce qu'on attend du programme XSLT, 
sauf celui concernant le tag Theatre puisque precisement notre programme est cense 
traitercet element en lui appliquantune regie explicite. L'element<Theatre> n'etantpas 
reconnu par I e motif de cette regie, la cause de I 'erreur est done maintenant facile a trouver. 



Conclusion 



Nous venons de voir la structure generale d'un programme XSLT, constitue de regies, 
avec leur motifs et leurs modelesde transformation. Uneregles'appliquea un noeud si 
son motif concorde avec le noeud ; dans cecaslemodelede transformation est instancie, 
et nous avons vu les deux instructions les plus representatives qui entrent en jeu lors de 

Cesinstanciations, xsl :va1ue-of, etxsl :apply-templates. 

Nous allons maintenant voir plus en detail les instructions disponibles en XSLT, en les 
classant par grandes categories : les instructions de transformation (comme xsi :vaiue- 
of et xsi :appiy-tempiates), les instructions de programmation, comme xsi:if, ou 

xsl : variable, et deS instructions de Creation, COmme xsl : element, OU xsl : attribute. 

Comme toute classification, celle-ci est bien sur contestable, car il suffit de prendre un 
autre point de vue pour en obteni r une autre completement differente , ou pour se rendre 
compte que final ement, telle instruction classee dans les instructions de programmation 
auraitaussi bien pu etre classee dans les instructions de transformation. II nefautdonc 
pas y voir autre chose qu'un moyen commode pour amener les notions progressivement. 



Les instructions 
de transformation 



Ce chapitre a pour but de faire decouvrir les instructions de transformation du langage 
XSLT, et d'en montrer le fonctionnement. L'exhaustivite propre a un manuel de refe- 
rence n'est pas recherchee ici, et tout ce qui aurait pu etre de nature a perturber la 
comprehension au point ou I 'on en est dans la lecture de I'ouvrage a ete elimine. 

Une annexe (voir Reference des instructions XSLT, page 623) reprendra la liste generale 
detoutes les instructions, avec cettefois I'integralite des attributs, de leurs proprietes, et 
de leurs valeurs possibles. 

A tout seigneur, touthonneur : nous commencerons done par I 'instruction xsi :tempiate 
qui definit une transformation. Ensuite, nous verrons les deux instructions de base, 

xsl :value-of, et xsl : apply-templ ates. NOUS poursuivrons aveC xsl :for-each, la COU- 

sinedexsi :appiy-tempiates. Puisviendra leurassociee, xsi :sort. Enfin, noustermine- 
ronsparl'instruction xsi :copy-of, cousinedexsi :vaiue-of. 

Peut-etre n'est-il pas inutile d'expliquer pourquoi classer ces instructions dans la catego- 
rie des instructions de transformation. A pres tout, X SLT veut dire XSL Transformations, 
done toute instruction de ce langage pourrait valablement etre qualified d'instruction de 
transformation. 

Cependant, ce qui fait reellement I 'original ite et la puissance de XSLT, e'est son mo- 
dele de traitement (voir M od<?le de traitement, page 87). Et ce modele de traitement est 
concu pour fonctionner en faisant appel aux instructions xsi :vaiue-of et xsi rappiy- 
tempiates, sans lesquelles il n'est plus rien ; et reciproquement, ces instructions sont 
inutiles et inoperantes sans le modele de traitement. Les autres instructions listees ci- 
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dessus sontdela memeveine, et parti ci pent aussi a la mi seen ceuvredu model e detrai- 
tement, tout en etantdejamoins indispensables. 

Cequ'il fautdonc retenir, c'est que ce que nous appelons instruction de transformation, 
ce n'est pas une instruction effectuant en elle-meme une transformation quelconque, 
maisune instruction integreeau coeurdu modelede transformation. 

Les autres instructions, que nous avons classees dans les categories d' instructions de pro- 
grammation ou de creation, pourraienttres bien etresupprimeesdu langageXSLT sans 
que cela casse le modele de traitement, qui conserverait toute la puissance de son prin- 
cipe. Ces instructions apportent des facilites complementaires, et augmentent chacune a 
leur manierele champ d'application du langage, maissansrien apporter de fondamenta- 
lementnouveauau modelede traitement, qui a la I imite, peutsecontenter del 'instruction 

xsl template, et des deUX instructions xsl:va1ue-Of et xsl :apply-templates pour 

fonctionner. 

Instruction xshtemplate 

Cette instruction adejaete largementdetailleeal'occasion de la description de ['instruc- 
tion xsi :vaiue-of (voir Instruction xsl:value-of, page 102) : nous nous contenterons de 
rappeler les elements essentiels et les variantes syntaxiques. 



Syntaxe 



xsl : tempi ate 



I: tempi ate match="... motif .. 
<!-- modele de transformatior 



<!-- fin du modele 
</xsl : tempi ate> 



instruction xsi :tempiate doit apparaitre uniquement comme instruction de premier 
niveau. 

Semantique 

Cette instruction, qui definit une regie, estau coeurdu fonctionnementdu langageXSLT ; 
on se reportera aux sections M od<?le de traitement, page 87, M otifs (patterns), page 91 et 
Priority entre regies, page 100. 

Instruction xsl:value-of 

Cette instruction a dejaete largement detaillee (voir Instruction xsl:value-of, page 102) : 
nous nous contenterons d'en indiquer les elements essentiels et les variantes syntaxiques. 



Instruction xsl:value-of 



Syntaxe 

xsl :value-of 

<xsl:value-of select^"... chemin de localisation ..." /> 

L'instruction xsl :vaiue-of ne doit pas apparattre en tant qu'instruction de premier 

niveau. 

Le chemin de localisation fourni commevaleurde I 'attri but select n'estpaslimiteacer- 

taines formes comme c'est le cas pour le motif (voir Syntaxe et contrainte pour un motif 

XSLT, page 98) ; toute la puissance expressive du langageXPath estici uti Usable. 

Regie XSLT typique 

U ne regie X SLT uti I isant l'instruction xsi : vai ue-of va typiquement avoir la forme : 



<!-- fin du modele de transformation --> 
</xsl : tempi ate> 

Semantique 

Lors de I'instanciation du modele, le motif de la regie est en concordance avec le nceud 
courant(lenceud en coursdetraitement). C'est ce nceud qui fait office de nceud contexte 
dans I 'evaluation du chemin de localisation fourni commevaleurde I 'attri but select. 

Comme son nom I'indique, l'instruction <xsi :vai ue-of seiect="... n /> estremplacee 
lors de I'instanciation du modele par la valeur textuel le de ce qui est designe par I 'attri but 
select. II s'agitdonc de la valeur textuelle (i.e. sous forme de chaine de caracteres) d'un 
node-set, ou d'un booleen, ou d'un nombre, ou d'une chaine de caracteres, suivant la 
valeur renvoyee lors de devaluation du chemin de localisation. 

Un booleen ou un nombre est converti en chaine de caracteres par appel de la fonction 

stringO. 

U n node- set comportant en general plusieurs nceuds source, sa valeur textuelle est definie 
comme etant eel ledu nceud source qui arrive en premier dans I'ordrede lecture du docu- 
ment. L'instruction est done final ement remplacee par la valeur textuelle d'un nceud (un 
seul), notion qui a ete definie a la section Module arborescent d'un document XML vu par 
XPath, page 30 et suivantes. 
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Exemple 



<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

<Organisation> Anacreon </Organisation> 
<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 
<Lieu>Chapelle des Ursules</Lieu> 
</Concert> 



;t Lyres </Organisation> 
1999 <Heure> 21H </Heure> < 
-s</Lieu> 



<Theatre> 

<Organisation> Masques 

<Date>Mardi 19 novembre 

<Lieu>Salle des Cordelier 
</Theatre> 
<Theatre> 

<Organisation> Masques et Lyres </Organisation> 

<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> < 

<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 



<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" version = "1.0"> 

<xsl:output method='text' encoding='UTF-8'/> 

<xsl :template match=7'> 

Date Concert : <xsl :val ue-of select="Saison/Concert/Date"/> 
Date Theatre : <xsl :val ue-of select="Saison/Theatre[l]/Date"/> 
Date Theatre : <xsl :val ue-of select="Saison/Theatre[2]/Date"/> 

</xsl :template> 

</xsl:stylesheet> 

Appliqueeaufichier saison.xmi , cettefeuille de style produit le resultat suivant : 



Date Concert 
Date Theatre 
Date Theatre 



: Samedi 9 octobre 1999 20H30 
: Mardi 19 novembre 1999 21H 
; Mercredi 20 novembre 1999 21H30 



La declaration <xsi : output method='text' encoding='UTF-8'/> permet de specifier 
quel'on veutgenererun resultat qui sera un simple document texte (encode en UTF-8), 
et non pas un document XML balise comme il se doit. Si I'on supprimait cette 
declaration, voici le resultat que I 'on obtiendrait: 

<?xml version="1.0" encoding="UTF-8"?> 



Date Concert : Samedi 9 octobre 1999 20H30 



Instruction xshapply-templates 



Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H30 

soit a peu pres la meme chose, sauf le preambule de fichier XML genere automatique- 
ment, en contradiction avec la suite du fichier qui n'a pasdu toutl'aird'un fichier XM L. 

Variante syntaxique 

On peut si I'on veut ajouter un attri but disabie-output-escaping a I 'element 
xsi :vaiue-of, commececi : 

<xsl :value-of select^"..." disable-output-escaping="yes [no" /> 

Cet attri but vaut no par defaut, ce qui veut dire que les caracteres speciaux pour XML 
(comme< ou > ) sontsortis sous forme d'entites caracteres (&it; ou &gt : ). 

Instruction xshapply-templates 

Cette instruction a deja ete largement detaillee (voir Instruction xsl: apply- templates, 
page 107) : nous nous contenterons d'en indiquer les elements essentiels et les variantes 
syntaxiques. 

Syntaxe 

<xsl :apply-templates /> 

L'instruction xsi :appiy-tempiates ne doit pas apparaitre en tantqu'instruction de pre- 
mier niveau. 

Regie XSLT typique 

Une regie XSLT utilisant I 'instruction xsi :appiy-tempiates aura souvent la forme: 





<xsl : tempi ate match="... motif (pattern) 




<!-- modele de transformation --> 




... texte ... 




<xsl :apply-templates /> 




. . . texte . . . 




<!-- fin du modele de transformation 


1 


</xsl: tempi ate> 


Seman 


tique 



Lors del'instanciation du modele, le motif de la regie est en concordance avec le nceud 
courant (le noeud en cours de traitement) ; l'instruction <xsi :appiy-tempiates/> est 
remplacee par le fragment de document qui resulte du traitement de la I i ste des enfants du 
noeud courant. Le detail important, ici, est que cette I i ste, que nous avions deja evoquee 
(voirlnstanciation d'un module de transformation relativementaun na?ud courant et une 
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liste courante, page 90) est constitute avec les elements enfants du nceud courant, pris 
dans I'ordre de lecture du document source. 



Exemple 



<ml version="1.0" encoding="UTF-8"?> 
si :stylesheet 
xmlns:xsl = "http://www.w3.org/1999/XSL/Tre 



<xsl:output method='text' encoding='UTF-8'/> 

<xsl :template match=7'> 

<xsl :apply-templates/> 
</xsl :template> 

<xsl :template match='Saison'> 

Manifestations au programme 

<xsl :apply-templates/> 

Reservations 10 jours avant la date. 
</xsl :template> 

<xsl :template match='Concert'> 

Concert : <xsl :val ue-of select="."/> 
</xsl :template> 

<xsl rtemplate match='The§tre'> 

Theatre : <xsl :val ue-of select="."/> 
</xsl :template> 



</xsl:stylesheet> 

Appliquee au meme fichier saison.xmi que celui vu precedemment (voir Exemple, 
page 130), cette feuille de style produit le resultat suivant : 



Concert : 

Pygmal ion 
Samedi 9 octobre 1999 20H30 
Chapelle des Ursules 



Theatre : 

Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 



Instruction xshapply-templates 



Theatre : 






Aristophane 






Mercredi 20 novembr 


1999 


21H30 


Salle des Cordelier 







Variante syntaxique select="..." 

On peut si I'on veut ajouter un attribut select a I 'element appiy-tempiates , comme 
ceci : 

<xsl :apply-templates select^"... chemin de localisation ..." /> 

L'effetdel'attri but select est demodifier la constitution dela nouvellelistedenceudsa 
traiter : en I'absence de seiect=". . .", cette liste contient tous les enfants directs du 
nceud courant; mais si I 'attribut select estfourni, sa valeur (un chemin de localisation) 
est calculee, cequi donneun node-set, et les elements dece node-set, prisdansl'ordrede 
lecture du document XM L, vontalorsconstituer la nouvellelistedenceudsa traiter. 

En principe, le chemin de localisation que I'on fournit pour I 'attribut select fait partie 
des descendants du nceud courant, meme si la specification du langageXSLT n'impose 
pas cette contrainte. En tous cas, c'est une bonne pratique que de se I i miter a ce genre de 
node-set. Si I'on transgresse cette regie debon sens, on risque d'introduire une recursion 
infinie dans le fonctionnement du processeur X SLT : 

<xsl : tempi ate match='truc'> 

<xsl :apply-templates select="."/> 

</xsl :template> 

lei, on impose au processeur X SLT une recursion infinie, puisque I 'attribut select selec- 
tionne le nceud courant lui-meme, qui va done indefiniment concorder avec le motif de 
cette regie, indefiniment reactivee. 

Dans I'exemple que nous venons de voir (voir Exemple, page 132), on pourrait vouloir 
faire apparaitre les pieces de theatre avant les concerts ; cela pourrait se faire ainsi : 



<xsl :stylesheet 



••"1.0" encoding="UTF-8"?> 

= "http://www.w3.org/1999/XSL/TransforiT 



<xsl:output method='text' encoding='UTF-87> 

<xsl : tempi ate match='/'> 

<xsl :apply-templates/> 
</xsl :template> 
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Manifestations au programme 
<xsl :apply-templates select="Theatre'7> 
<xsl :apply-templates select="Concert"/> 
Reservations 10 jours avant la date. 
</xsl :temp1ate> 

<xsl :template match='Concert'> 

Concert : <xsl :val ue-of select="."/> 
</xsl :template> 

<xs1: tempi ate match='Theatre'> 

Theatre : <xsl :val ue-of select="."/> 
</xsl :template> 

</xsl:stylesheet> 

Le resultat obtenu serai t alors le suivant : 

Manifestations au programme 

Theatre : 
Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 

Theatre : 
Aristophane 
Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 

Concert : 

Pygmal ion 
Samedi 9 octobre 1999 20H30 
Chapelle des Ursules 

Reservations 10 jours avant la date. 

Variante syntaxique mode="..." 

On peutsi I 'on veutajouter un attri but mode al'elementappiy-tempiates , commececi : 

<xsl :apply-templates mode="nom-de-mode" /> 

L'emploi de cet attri but va de pair avec la definition de regies XSLT differentes appli- 
cablesau meme element source, ces regies etantetiquetees par un nom demode pour les 
differencier : 

<xsl :template match='...' mode="model"> 

I</xsl :templ ate> 
<xsl :template match='... la meme chose ...' mode="mode2"> 
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</xsl :template> 

Lors de la definition d'un modele de transformation, on peut utiliser I'instruction 
xsi :appiy-tempiates en precisant le mode choisi, cequi aura poureffetdeselectionner, 
parmi les differentes regies egalement applicables, celledont le mode est egal au mode 
choisi : 

<xsl :apply-templates mode="model" /> 

La consequence est qu'un meme element peut etre traite pi usieurs fois, par des regies dif- 
ferentes, une par mode. 
C'est cequi distingue la notion de mode decellede priorite : 

• Avec la notion de mode, on introduit volontairement des ambiguites potenti el I es en 
ecrivant plusieurs regies simultanement eligibles (le plus souvent, elles ont le meme 
motif, mais ce n'est pas obligatoire). Ces regies simultanement eligibles sont asso- 
ciees chacune a des modes differents afin de pouvoir choisir la bonne par I'interme- 
diaire d'une instruction <xsi :appiy-tempiates mode=". . ."/>, qui specifie le mode 
adequatenfonction de I'instruction en cours. 

• Avec la notion de priorite, on cherche au contraire a eliminer toute ambiguite, en 
affectant unefois pour toutes des priorites differentes aux regies qui pourraienteven- 
tuellement etre simultanement eligibles: a I'execution, si I'ambiguite se presente, 
c'est toujours la meme regie qui estchoisie (cellede plus haute priorite), ettoujours 
les memes qui sontecartees. 

En resume, avec la notion de mode, les differents choix possibles restent ouverts 
jusqu'au dernier moment, alors qu'avec celle de priorite, on ferme tout des le depart. 

Exemple 

N ous conservons le meme exemple de fichier X M L a traiter ; mais cette fois, imaginons 
queletexteaproduiresoitdestineaun service municipal qui a notammenten charge de 
prevoir le chauffage des sal les uti Usees. On veut un texte qui puisseetre integre dans une 
note de service qui annonce les manifestations a venir, etqui recapitule a la fin les direc- 
tives de chauffage. 

Le probleme ici est qu'un meme element (par exemple <ueu> ) devra etre traite deux 
fois : une fois en tant que donnee d'une manifestation, et une fois en tant que donnee 
d'une directive de chauffage. 

La solution est de definir deux modes de traitement : un mode « annonce » et un mode 
« logistique ». Le programme XSLT prend la forme suivante : 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encoding='UTF-8'/> 
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<xsl :template match=7'> 

<xsl :apply-templates/> 
</xsl :template> 

<xsl :template match='Saison'> 
Manifestations a venir 

<xsl :apply-templates select="Theatre" mode="annonce"/> 
<xsl :apply-templates select="Concert" mode="annonce"/> 
Chauffage 

<xsl :apply-templates select="Theatre" mode="logistique"/> 
<xsl :apply-templates select="Concert" mode="logistique"/> 

</xsl :template> 

<xsl rtemplate match='Concert' mode="annonce"> 

Concert : <xsl :va1 ue-of select="."/> 
</xsl :template> 

<xsl :template match='The§tre' mode="annonce"> 

Theatre : <xsl :va1 ue-of select="."/> 
</xsl :template> 

<xsl :template match='Concert' mode="logistique"> 

le <xsl:value-of select="Date"/>, <xsl :va1 ue-of select="Lieu"/> 
</xsl :template> 

<xsl :templ ate match='Theatre' mode="logistique"> 

le <xsl:value-of select="Date"/>, <xsl :va1 ue-of se1ect="Lieu"/> 
</xsl :template> 

<xsl :template match='Organisation' mode="logistique"> 
</xsl :temp1ate> 

</xsl:stylesheet> 

L e resultat obtenu est alors le suivant : 

Manifestations a venir 

Theatre : 
Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 

Theatre : 
Aristophane 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 
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Samedi 9 octobre 1999 20H30 
Chapel le des Ursules 



a Mardi 19 novembre 1999 21H , Salle des Cordeliers 
; Mercredi 20 novembre 1999 21H30 , Salle des Cordelie 
; Samedi 9 octobre 1999 20H30 , Chapelle des Ursules 



Instruction xshfor-each 

Cette instruction est la cousine de xsi :appiy-tempiates, en ce sens que xsi:appiy- 
tempiates etxsi :for-each sont I es deux seules instructions du langagequi, lorsdel'ins- 
tanciation du modele qui les heberge, provoquent la creation d'une nouvelle liste de 
nceuds, traitee recursivement (voir I nstanciation d'un module de transformation relative- 
menta un na?ud courant et une liste courante, page 90). Bien siir, les effets deces deux 
instructions sont differents, mais neanmoins, el les declenchent des mecanismes assez 
semblables. 



Bande-annonce 



;ncoding="UTF-8"? 



<Cor 



ert> 



<0rganisation> Anacreon </0rganisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 
</Concert> 
<Theatre> 

<0rganisation> Masques et Lyres </0rganisation> 

<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 
<Theatre> 

<0rganisat 

<Date>Merc 

<Lieu>Sall 
</Theatre> 



> Masques et Lyres </0rganisation> 

i 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 

as Cordeliers</Lieu> 



<?xml version=": 
<xsl :stylesheet 



0" encoding="UTF-8"?> 

i:xsl = "http://www.w3.org/1999/XSL/Tra 

on = "1.0"> 

output method='text' encoding=' IS0-88E 
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sl:template match='Saison'> 
<xsl :for-each select="Theatre"> 
Date Theatre : <xsl :val ue-of 
</xsl:for-each> 

<sl :template> 



</xsl:stylesheet> 
Resultat 



Syntaxe 



l:for-each select^".. 



chemin de 1 



jatioi 



</xsl :for-each> 

instruction xsi:for-each ne doit pas apparaitre en tant qu'instruction de premier 
niveau. 



Regie XSLT ty pique 

Une regie XSLT utilisant instruction > 



ich sera souvent employee comme 



<xsl :template match""... motif (pattern) ..."> 
<!-- modele de transformation englobant --> 
... texte ou instructions XSLT ... 
<xsl:for-each select=" . . . "> 

<!-- modele de transformation propre au for-eac 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation englobant --> 
</xsl :template> 



Semantique 



Remarque 

II n'est peut-etre pas inutile de preciser tout d'abord que I'instruction <xsl :for-each> n'est pas une ins- 
truction pour effectuer une boucle, etn'a done rien avoiravec la boucle for( ..;..;..) que I'on trouve en C ou 
en Java. En particulier, la notion decompteurquis'incremente est une notion tres etrangereaXSLT :XSLT est 
un langage qui ne permet pas de faire evoluer la valeur d'une variable ; rappelons que XSLT s'apparente aux 
langages fonctionnels (comme ML ou Caml) lorsqu'il s'agitde faire de I'algorithmique. 
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Chapitre 4 

Lorsdel'instanciation du modele englobant, le motif de la regie est en concordance avec 
lenoeud courant(lenceud en coursdetraitement) ; I 'instruction <xsi :for-each>, faisant 
partie de ce modele de transformation englobant, est remplacee par le fragment de 
document qui resulte du traitement de la liste des nceuds selectionnes par son attri but 

select=". . .". instruction <xsl :for-each> est la Seule, avec <xsl :apply-templates>, 

a induire la construction d'une nouvelle liste de nceuds, eta lancer un traitement sur cette 
liste. Commedanslavariantesyntaxique<xsi :appiy-tempiates seiect=". . .">, la liste 
des nceuds a traiter est etablie d'apres la valeur du chemin de localisation fourni dans 
I 'attri but seiect="...". En fait, la seule difference appreciable entre <xsi :for-each 

select=". . ."> et <xsl : apply-templ ates select=". . ."> est que pour xsl :for-each, 

la regie a appliquer a chaque nceud de la liste n'est pas recherchee parmi I'ensemble 
des regies du programme XSLT, commedans lecasde<xsi :appiy-tempiates seiect= 
"...">, maisau contraire, lememe model ede transformation est applique uniformement 
achacund'entreeux. 

Le corps de instruction <xsi :for-each> (i.e. I'ensemble des elements fils del 'element 
<xsi :for-each>) constitue le modele de transformation uniformement applique a chacun 
des noeuds selectionnes. 

L e fragment de document qui resulte du traitement de cette liste est tel que eel a ete defini 
dans le modele de traitement : voir M odele de traitement, page 87. 



Exemple 



Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

version = "1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1 '/> 

<xsl : tempi ate match='Saison'> 

<xsl :for-each select="Theatre"> 

Date Theatre : <xsl :val ue-of select="Date"/> 

</xsl:for-each> 
</xsl :templ ate> 

</xsl:stylesheet> 



<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

i<Organisation> Anacreon </Organisation> 
<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 
<Lieu>Chapelle des Ursules</Lieu> 
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<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date 
<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Masques et Lyres </Organisation> 
<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> < 
<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 
iaison> 



Date Theatre : Mardi 19 novembre 1999 21H 
Date Theatre : Mercredi 20 novembre 1999 21H30 

Autre semantique 

interpretation naturelle de <xsi :for-each> est celle d'une instruction permettant la 
repetition d'une meme transformation surplusieurs elements. Bien sflr, pour que ceci ait 
un sens, il faut qu'il y ait effectivement une structure reguliere, repetitive d'elements a 
traiter, et que ce fait soit connu au moment ou I 'on ecrit le programme X SLT. 

L'explication de la semantique de cette instruction fait intervenir deux modeles de 
transformation, I'un englobant, I'autre etant le modele de transformation propre au 

<xsl :for-each> : 

<xsl :template match="... motif (pattern) ..."> 
<!-- modele de transformation englobant --> 
... texte ou instructions XSLT ... 
<xsl :for-each select=" . . . "> 

<!-- modele de transformation propre au for-each --> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :for-each> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation englobant --> 
</xsl :template> 

M ais on peut aussi considerer un seul modele de transformation (ce n'est qu'une ques- 
tion de point devue) : 

<xsl :template match="... motif (pattern) ..."> 
<!-- modele de transformation --> 
... texte ou instructions XSLT ... 
<xsl :for-each select=" . . . "> 

... texte ou instructions XSLT ... 
</xsl :for-each> 

... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :template> 
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La seule modification concerne les commentaires : rien n'est done change pour le 
processeur XSLT. Pourtant cette presentation eclaire differemment la semantique du 

<xsl :for-each>. 

Le modele de transformation estici vu commeun modele unique, compose detrois par- 
ties: 

J <xsl :template match=". . . motif (pattern) ..."> 
<!-- modele de transformation --> 
<!-- premiere partie --> 
... texte on instructions XSLT ... 
<!-- fin premiere partie --> 
<xsl :for-each select=" . . . "> 
<!-- deuxieme partie --> 

... texte ou instructions XSLT ... 
<!-- fin deuxieme partie --> 
</xsl:for-each> 
<!-- troisieme partie --> 
... texte ou instructions XSLT ... 
<!-- fin troisieme partie --> 

i<!-- fin du modele de transformation --> 
</xsl:template> 

Deslors, le<xsi :for-eacn> apparait comme une instruction qui change temporairement 
lenceud courant pendant I 'instanciati on du modele de transformation, etcepointdevue 
peut etre encore renforce si I 'on imagine que le seiect="..." du <xsi :for-eacn> ne 
selectionnequ'un seul element. 

instruction <xsl :for-each> aurait aUSSi bien pu S'appeler <xsl ichange-current- 

En effet, lors de I'instanciation des premiere et troisieme parties du modele de transfor- 
mation, le motif de la regie est en concordance avec le nceud courant (le nceud en cours 
detraitement). L' instanciati on de la deuxieme partie se fait avec un autre nceud courant, 
celui selectionnepar l'attributseiect="... n del 'instruction <xsi :for-eacn>. 

Exemple 

On metici enceuvreun exemple qui reprend I'ideedu modele de transformation en trois 
partie, la deuxieme donnant lieu a une instanciation relativement a un (ou plusieurs) 
nceud(s) courant(s) different(s) du nceud courant en concordance avec le motif ; lefichier 
XML estlememe: Saison.xmi (voir Exemple, page 139) 

Saison.xsl 

|<?xml version="1.0" encoding="UTF-8"?> 
<xsl :stylesheet 
xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 



l:output method='text' encoding=' ISO-E 
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slitemplate match=' Concerts 
Apres le concert 
<xsl:value-of select="Organisation"/> du <xsl :val ue-of select="Date'7>, 

<xsl :for-each select='7Saison/Theatre"> 

Theatre (<xsl : value-of select="0rganisation'7>) , 

le <xs1: value-of select="Date"/> 
</xsl :for-each> 
Rappel des sal les : 
<xsl:value-of select="Lieu'7> 
<sl :template> 



<xsl :template match='Organi 
</xsl :template> 



<xsl :template match='Date'> 
</xsl :template> 



<xsl :template match= 


'Heure 


'> 


</xsl :template> 






<xsl :template match= 


'Lieu' 


> 


<xsl :value-of se 


lect=' 


."/> 


</xsl :template> 







</xsl:stylesheet> 

La premiere regie, dont le motif concorde avec lenceud <concert>, declare un modelede 
transformation en trois parties. 

Premiere parti e 

Apres le concert 

<xsl :value-of select="0rganisation'7> du <xsl :val ue-of select="Date"/>, 



Troisieme parti e 

I Rappel des sal 1 es : 
<xsl:value-of select="Lieu"/> 

La premiere et la troisieme seront instanciees relativement au nceud courant <concert>, 
alors que la deuxieme sera instanciee plusieurs fois, relativement a differents noeuds cou- 
rants (successivement tous les elements <Tneatre> enfants de la raci ne <sai son>). 

Leresultat est qu'achaque fois, les instructions 

<xsl :value-of select="0rganisation'7> 
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<xsl :value-of select="Date"/> 

de cette deuxieme partie sont instanciees differemment en fonction du noeud courant 
actif . L a troisieme partie est instanciee sous la forme : 

Rappel des salles : 
Chapelle des Ursules 

etc'estla regie 

<xsl : tempi ate match=' Lieu'> 



</xsl :template> 

qui complete la liste des salles. Appliquee au fichier saison.xmi, cette feuille de style 
produit le resultat suivant : 

Apres le concert Anacreon du Samedi 9 octobre 1999 20H30 

il y aura encore les spectacles suivants : 

Theatre ( Masques et Lyres ), le Mardi 19 novembre 1999 21H 

Theatre ( Masques et Lyres ), le Mercredi 20 novembre 1999 21H30 

Rappel des salles : 
Chapelle des Ursules 

Salle des Cordeliers 



La mise en page, et notamment la repartition des sauts de ligne n'est pas extraordinaire, 
mais nous verrons plus loin comment regler ce genre de probleme. 

Cet exemple met en jeu les regies par defaut, puisque aucune regie n'est fournie pour les 

elements <Saison> et <Theatre>. 

Pourl'element<saison> la regie 

<xsl :template match='/|*'> 
<xsl :apply-templates/> 
</xsl :template> 

s'applique, et relance le traitement sur les nceuds enfants <concert>, <Tneatre>, et 
<Tneatre>. Pour I 'element <concert> une regie explicite est fournie. Pour les elements 
<Tneatre> la regie par defaut 
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I <xsl template match=7|*'> 
<xsl :apply-templates/> 
</xsl :template> 

s'applique, et relance le traitement sur les nceuds enfants <organisation>, <Date>, et 
<Lieu>, ces elements etant pris en charge par des regies explicites. 

Instruction xshsort 

Bande-annonce 

L'instruction xsi :sort est une instruction de tri qui ne s'emploie que comme comple- 
ment a xsi :appiy-tempiates ou xsi :for-each : el I e sert a trier le node-set selectionne 
par I'unedeces deux instructions. L'exempleci-dessous montreun xsi :sort accompa- 

gnantun xsi :for-each. 



CDtheque.xml 

<?xml version="1.0" encoding="UCS-2" standalc 



<Compositeur> 

<nom> Couperin </nom> 
<prenom> Louis </prenom> 
<actifVers> 1670 </actifVers> 

</Compositeur> 

<Compositeur> 

<nom> Simpson </nom> 
<prenom> Thomas </prenom> 
<actifVers> 1610 </actifVers> 

</Compositeur> 

<Compositeur> 

<nom> Faugues </nom> 
<prenom> Guillaume </prenom> 
<actifVers> 1460 </actifVers> 

</Compositeur> 

<Compositeur> 

<nom> Aristophane </nom> 

<prenom> fils de Philippos d'Ath≠ 

<actifVers> -410 </actifVers> 
</Compositeur> 

<Compositeur> 

<nom> Simpson </nom> 

<prenom> Christopher </prenom> 
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I<actifVers> 1640 </actifVers> 
</Compositeur> 
</Compositeurs> 
</CDtheque> 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="l.C 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl :template match="Compositeurs"> 
<xsl :for-each select="Compositeur"> 
<xsl:sort select="nom"/> 
<xsl:value-of select="nom"/> 
</xsl :for-each> 
</xsl :template> 
</xsl :stylesheet> 

Resultat 

Aristophane Couperin Faugues Simpson Simpson 

Variantedetri : 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="l.C 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl :template match="Compositeurs"> 

|<xsl :for-each select="Compositeur"> 
<xsl:sort select="actifVers" data-type="number"/> 
<xsl:value-of select="nom"/> 
</xsl:for-each> 
</xsl :template> 
</xsl: stylesheet) 

Resultat 

Aristophane Faugues Simpson Simpson Couperin 



Syntaxe 

<xsl:sort/> 

instruction xsi 



t ne doit pas apparaitre en tant qu'instruction de premier niveau, et 
doit apparaitre dans lemodelede transformation d'un xsi :for-eacn ou d'un xsi :appiy- 

templ ates. 
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Regie XSLT typique 

Une regie XSLT uti I isant I 'instruction xsi : sort sera souvent employee commececi : 

<xsl :template match="... motif (pattern) ..."> 

<xsl:for-each select=". . . "> 

<xsl:sort/> 

<!-- modele de transformation propre au for-each --> 
... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 
</xsl:for-each> 

</xsl: tempi ate> 

ou encore commececi : 

<xsl :template match="... motif (pattern) ..."> 

<xsl :apply-templates> 

<xsl:sort/> 
</xsl :apply-templates> 

</xsl :template> 

Semantique 

instruction <xsi :sort/> nes'emploie pas seule; el I e est en fait lieeaux deux instruc- 
tions <xsi :for-eacn> et <xsi :appiy-tempi ates>, et ne peut s'employer autrement que 
commeassocieea I'unedecesdeux instructions. 

En I'absence d'une instruction <xsi:sort/>, les deux instructions <xsi :for-each> et 
<xsi :appiy-tempiates> constituent une liste des elements a traiter, basee sur I'ordre 
naturel de lecture du document XML. 

L'instruction <xsi :sort/> intervient done pour modifier I'ordre des elements de cette 
liste : par defaut (e'est-a-dire en I'absence d'attributs propres a <xsi :sort/> permettant 
de specifier les parametres du tri a effectuer), les elements de cette liste sont ordonnes 
suivant I'ordre lexicographique de la valeur textuelle de chaque element. 

L'instruction <xsi :sort/> est touj ours vide; ellepeutjusteetrecompleteepardifferents 

attributs que nous verrons plus loin. 

U ti I i see en association avec <xsi :for-eacn>, elledoit necessairementsetrouver placee 

avant le debut du modele de transformation inclus dans ce <xsi : f or-each>, comme on le 

voitdansl'exempleci-dessus. 

Note 

Employee dans un xsl : for-each la fonction position( ) renvoie le numero d'ordre du nceud courantau sein 
du node-set selectionne par I'attribut select du xsl : for-each. Si cette instruction xsl : for-each comporte 
une instruction xsl :sort, la numerotation consideree estcelle du node-set reordonne parle tri. 
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Exemple 



Nous reprenons I 'exemple relatif a I'instruction <xsi :appiy-tempiates> , tel qu'il est 
traite a la section Instruction xshapply-templates, page 131. Le fichiers XML est le 
memequecelui dej a uti I isecomme exemple (voir Exemple, page 132) : 



<?xml version="1.0" encoding="UTF-8"?> 
<Saison> 

<Concert> 

<Organisation> Pygmalion </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Concert> 

<Theatre> 

<Organisation> Masques et Lyres </Orgam'sation> 
<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 
<Lieu>Salle des Cordeliers</Lieu> 

</Theatre> 

<Theatre> 

<Organisation> Aristophane </Organisation> 

<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 

</Theatre> 
</Saison> 

Le fichier XSLT est lui aussi le mSme, a ceci pres que I'on ajoute une instruction 

<xsl :sort/> a I 'instruction <xsl :apply-templates> : 

Saison.xsl 

<?xml version="1.0" encoding="UTF-8"?> 

<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method='text' encoding='UTF-8'/> 



</; 



1 :template match=' /'> 
<xsl :apply-templates// 
si :template> 



<xsl :template match='Saison'> 

Manifestations au programme 

<xsl :apply-templates> <xsl:sort/> </xsl :apply-templates> 

Reservations 10 jours avant la date. 
</xsl: template) 

<xsl :template match='Concert'> 

Concert : <xsl :val ue-of select="."/> 
</xsl :template> 
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I</xsl:template> 
</xsl: stylesheet) 

Resultat 

Manifestatic 



Theatre : 
Aristophane 

Mercredi 20 novembre 1999 21H30 
Salle des Cordeliers 

Theatre : 
Masques et Lyres 
Mardi 19 novembre 1999 21H 
Salle des Cordeliers 

Concert : 

Pygmal ion 
Samedi 9 octobre 1999 20H30 
Chapelle des Ursules 

Reservations 10 jours avant la date. 

Nous reprenons le deroulement du processus de traitement sur cet exemple (voir Consti- 
tution d'une liste necontenantque la racine, page 108), qui ne change en rien, sauf une 
fois arrive a I'etape representee par la figure 3-21, que I'on rappelle ici (voir figure 4-1). 
Sans I'instruction <xsi :sort/>, la constitution, par <xsi :appiy-tempiates>, de la liste 
des elements a traiter, se fait dans I'ordre de lecture du document. 
Avec I'instruction <xsi :sort/>, la constitution, par <xsi :appiy-tempiates>, de la liste 
des elements a traiter, se fait dans I'ordre lexicographiquede la valeur textuelle des ele- 
ments (voir figure 4-2). 

La valeur textuelle des trois elements <Tneatre/>, <The§tre/>, <concert/> est obtenue 
comme explique a la section No>ud de type element, page 31, et aux figures 3-23, 3-25, 
3-27 de la section Instanciation du module de transformation, page 118. Ici, les mots 
Pygmalion, Masques et Lyres, Aristophane imposent leur ordre lexicographique a leurs 
trois elements respectifs. 
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M odele 



jnifestations au programme 



Fragment de 
document resultat 

- -»- Manifestations au programme 




Concert 
— • 



Traitement 

du nceud 

Concert 

(2) 



Traitement 
du noeud 

(3) 



Traitement 
du nceud 

(4) 



t t t _ 



Figure 4-1 

I nstanciation du modelede transformation (sans <xsl:sort/>). 
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Modele 



Fragment de 
document resultat 



anifestations au programme 



</xsl:apply-templates> 



Generation d'une 

nouvelleliste 

ordonnee 

lexicographiquement 



Traitement 
du nceud 



Traitement 
du nceud 



Traitement 
du noeud 
Concert 



Instantiation du modele de transformation (avec <xsl:sort/>). 



Instruction xshsort 



Variantes syntaxiques 

On peut, si I'on veut, ajouter a I 'instruction <xsi :sort/> les attributs suivants : 

lang="..." data-type=" . . . "/> 

Ces attributs permettent de preciser les differents parametres du tri, que nous allons 
maintenant passer en revue. 

Attribut select 

Signification 

L' attribut select estessentiel, car il definit la cle detri, c'est-a-direla chaine de carac- 
teres a extraire de I 'element en cours de placement, sur laquelle portera le tri. 

Valeur possible 

On peut fournir une expression XPath quelconque, qui est evaluee, comme il se doit, 

relativement a un nceud contexte et a une liste contexte. 

Le noeud contexte est le noeud en cours de placement, et la liste contexte est la liste de 
nceuds (conservee dans son etat originel), produite par instruction directement englo- 
bante, c'est-a-dire, suivant les cas, soit par instruction <xsi :appiy-tempiates/>, soit 

par I'inStrUCtion <xsl :for-each/>. 

Cette expression ne donne pas forcement une chaine de caracteres comme resultat (on 
obtient meme un node-set dans le cas le plus general), mais s'il le faut, la fonction 
stringo lui est appliquee, et la chaine de caracteres qui en resulte constitue alors la cle 
detri. 



II y a en fait deux listes en jeu : celle avant et celle apres le tri. Le fait que la liste contexte soit celle conservee 
dans son etat originel, done avant le tri, rend possible ('utilisation de la fonction positionQ au sein de I'expression 
XPath. 



Valeur par defaut 

La valeur par defaut est egale a stnngt.), qui n'est rien d'autre que la valeur textuelle 

du noeud courant. 

Autres attributs 

Les autres attributs sont des parametres qui permettent de regler la facon dont le tri est 
effectue. 



L'attri but order definit I'ordre du tri (ascendant ou descendant) ; il peut prendre I 'une 

deS deUX valeurs ascendi ng OU descendi ng, et Sa valeur par defaut est ascendi ng. 
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Note 

Techniquement, sontacceptees ici des valeurs d'attribut ordinaires (des chaTnes de caracteres, comme on en a 
I'habitude), mais aussi, etde fagon assez exceptionnelle en XSLT, des Attribute Value Template, notion qui sera 
introduite beaucoup plus loin (voir Descripteur de valeur differee d'attribut (Attribute Value Template), page 269). 
Mais on pourra ignorercette remarque en premiere lecture, puisque les valeurs d'attributs ordinaires sontaccep- 



• Cise-order 

L'attribut case-order definit la relation d'ordre entre les lettres minuscules et majus- 
cules ; il peut prendre I 'une des deux valeurs upper-first ou iower-first,etsa valeur 
par defaut depend dela langue utilisee. 

• lang 

L'attribut 1 ang definit la langue utilisee, et par la meme, les conventions de tri propres 
a cette langue ; sa valeur est un des codes de langue definit par X M L , et sa valeur par 
defautdependdel'environnementdetraitement. 

• data-type 

L'attribut data-type definit la nature de la de, afin de savoir comment comparer deux 
des. Essentiellement, cette nature peut etre de type texte (comparaison de chaines de 
caracteres) ou numerique (comparaison de nombres) ; sa valeur est done soit text, soit 
number. Une autre valeur possible est un code special propre a une implementation 
particuliere de XSLT, qui offre cette valeur en extension, et indiquenaturellementce 
qu'elle signifie. On peut penser qu'un code date serait tres utile, car rien n'a ete prevu 
en standard pour comparer des dates lors d'un tri, alors que ni text ni number ne 
conviennent. 

La valeur par defaut est "text". 

Exemple 

On dispose d'une base de donnees de CDtheque, constitute d'informations sur les com- 
positeurs, lesceuvres, lesenregistrements, etc. 

U n extrait de cette base pourrait ressembler a ceci : 

CDtheque .xml 

<?xml version="1.0" encoding="UCS-2" standalone="yes"?> 

<CDtheque> 

<Compositeurs> 

<Compositeur> 

<nom> Couperin </nom> 
<prenom> Louis </prenom> 
<actifVers> 1670 </actifVers> 
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</Compositeur> 

<Compositeur> 

<nom> Simpson </nom> 

<prenom> Thomas </prenom> 

<actifVers> 1610 </actifVers> 
</Compositeur> 

<Compositeur> 

<nom> Faugues </nom> 

<prenom> Guillaume </prenom> 

<actifVers> 1460 </actifVers> 
</Compositeur> 

<Compositeur> 

<nom> Aristophane </nom> 

<prenom> fils de Philippos d'Athenes </prenom> 

<actifVers> -410 </actifVers> 
</Compositeur> 

<Compositeur> 

<nom> Simpson </nom> 

<prenom> Christopher </prenom> 

<actifVers> 1640 </actifVers> 
</Compositeur> 

</Compositeurs> 

</CDtheque> 

Pour editer les compositeurs par ordre alphabetique de leur nom, on peut ecrire la feuille 
de style suivante: 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl :template match="Compositeurs"> 
<xsl :for-each select="Compositeur"> 
<xsl:sort select="nom"/> 
<xsl:value-of select="nom"/> 
</xsl:for-each> 
</xsl :template> 
</xsl :stylesheet> 

Leresultatobtenu estlesuivant: 

Aristophane Couperin Faugues Simpson Simpson 
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Letri sefait ici avec toutes les valeurs par defautdes attributs order, case-order, lang, 

et data-type. 

Supposons maintenant que nous voulions faire un tri par les dates, nous pouvons alors 
extrairelecontenu del 'element <actifvers> pour en faire unecle detri. Afin demon- 
trer la difference entre tri numeriqueettri alphanumerique, nousavonsajoute une entree 
« A ristophane » dans le fichier XML donne. 



Aristophane eta it un Grec, actif vers le iv e siecle avantj C, qui nous a laisse un peu de musique, gravee surdes 
dalles de marbre conservees a Delphes. Cette musique a reellementete enregistree surCD (plus recemment). 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xs1: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl :template match="Compositeurs"> 
<xsl :for-each select="Compositeur"> 

<xsl:sort select="actifVers" data-type="number"/> 
<xsl:value-of select="nom"/> 
</xsl:for-each> 
</xsl :template> 
</xsl:stylesheet> 

Leresultatobtenu estlesuivant: 

Aristophane Faugues Simpson Simpson Couperin 

On remarquera que ce qui est appele ici tri sur les dates est en fait un tri sur des entiers, 
caril n'y a pas encore, enXSLT, de type dedonnee normalise correspondant a une date. 

Si on avaitomisdepreciser I 'attri but data-type, savaleur par defaut (text) aurait ete uti- 
I i see, cequi aurait donne le resultat suivant : 

Faugues Simpson Simpson Couperin Aristophane 

Tri a cles multiples 

II est possible depreciserplusieurscles detri : quand deux elements ontmemevaleur par 
la premiere cle detri, on les departage avec ladeuxiemecle, etainsi de suite. Dansnotre 
exemple, on peututiliser une deuxieme cle detri surleprenom, pour affiner letri sur le 
nom qui donne un doublon (Simpson). 

Voyonsce que donne I 'edition du nom +prenom sans cle detri secondaire(remarquerla 
presence d'un « » : « »xsl:value-of ) : 
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CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl :template match="Compositeurs"> 
<xsl :for-each select="Compositeur"> 
<xsl:sort select="nom"/> 
<xsl:value-of select="nom"/> 
<xsl :value-of select="prenom"/>; 
</xsl:for-each> 
</xsl :templ ate> 
</xsl:stylesheet> 

Leresultatobtenu estlesuivant: 

IAristophane fils de Philippos d'Athenes ; 
Couperin Louis ; 
Faugues Guillaume ; 
Simpson Thomas ; 
Simpson Christopher ; 

Nous necherchons pas pour I 'instant a expliquer la presentation obtenue, notamment la 
presence des sauts de ligne, qui ne se manifestaient pas dans les exemples precedents. 

On observe que les deux Simpson ne sont pas classes dans I'ordre de leur prenom. On 
ajoute alors une deuxieme cle de tri : 

CDtheque.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings ISO-8859-1' /> 

<xsl :template match="Compositeurs"> 
<xsl :for-each select="Compositeur"> 
<xsl:sort select="nom"/> 
<xsl:sort select="prenom"/> 
<xsl:value-of select="nom"/> 
<xsl:value-of select="prenom"/>; 
</xsl:for-each> 
</xsl :templ ate> 
</xsl:stylesheet> 

Leresultatobtenu estlesuivant: 

Aristophane fils de Philippos d'Athenes ; 

I Couperin Louis ; 
Faugues Guillaume ; 
Simpson Christopher ; 
Simpson Thomas ; 
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Instruction xsl:copy-of 

Cette instruction est la cousine de <xsi :vaiue-of/> ; mieux : partout oil <xsi :vaiue- 
of/> est utilisee, on pourrait la remplacer par <xsi :copy-of/> sans que cela change le 
resultat obtenu. Bien sfir, la reciproque est fausse, et remplacer une occurrence quel- 
conquede<xsi :copy-of/> par <xsi :vaiue-of/> peut changer I e resultat. 



Bande-annonce 



instruction <xsl:copy-of select=' 

conforme des elements selectionnes. 



"/> est instanciee sous la forme d'une copie 



i="1.0" encoding="UTF-16" standalc 



<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Interpretes> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Silvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 
</Interpretes> 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns :xsl="http: //www. w3.org/1999/XSL/Transforn 



<xsl:output method^'xml ' encoding=' ISO-8859-1' indent^'yes' /> 
<xsl : tempi ate match="Interpretes"> 



<xsl :copy-of select="Interprete"/> 
</Musiciens> 
</xsl :template> 

<xsl :template match="text( )"></xsl :template> 

</xsl: stylesheet) 
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<?xml version="l 
<Musiciens> 
<Interprete> 



2ncoding="IS0-8859-l"?> 



<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instiu 

</Interprete> 
<Interprete> 

<Nom> Silvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instia 



</Ir 



erpre 



Syntaxe 

<xsl:copy-of select="... chemin de localisation ..."/> 

L'instruction xsi:copy-of ne doit pas apparaitre en tant qu'instruction de premier 
niveau. 

Regie XSLT typique 

UneregleXSLT utilisant I 'instruction xsi :copy-of sera souvent employee commececi : 

<xsl : tempi ate match= n ... motif (pattern) ..."> 

<xsl:copy-of select=" . . . "/> 
</xsl :template> 



Semantique 



Lorsdel'instanciation du modele, le motif dela regie est en concordance avec lenceud 
courant(lenoeud en coursdetraitement). C'estcenoeud qui fait office denceud contexte 
dans I 'evaluation du chemin de localisation fourni commevaleurde I 'attri but select. 

L'instruction <xsi :copy-of>, comme son nom I'indique, effectue une copie du resultat 
de I 'evaluation du chemin de localisation. 

Si ce resultat est une chaine de caracteres, un booleen, ou un nombre, xsi :copy-of et 
xsi : vai ue-of ont exactement le meme effet (voir Semantique, page 129). 

Si le resultat est un node-set, I ' effet est tres different: le node-set est serialise. 
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La serialisation d'un node-set est une operation tres simple (malgre son nom un peu 
impressionnant), qui a pour resultat un fragment de document constitue de la juxtaposi- 
tion (ou concatenation) des fragments de documents obtenus en serial isant successive- 
ment chacun des nceuds du node-set, pris dans I'ordre de lecture du document source 
(voir figure 4-3). 




• 



lecture du Serialisation 

document 



Figure 4-3 

Serialisation d'un node-set. 



La serialisation d'un nceud, quant a die, est une operation encore plus simple qui 
consisted voir cenceud en tant que racine d'un sousarbre, etaserialisercesous-arbre. 
Nousavonsdejavu cela, (voir Construction - serialisation, page 84) maisrappelonsque 
la serialisation d'un arbre (ou d'un sous-arbre), est I 'operation inverse de sa construction 
a partir d'un document (ou d'un fragment de document) : la construction prend un (frag- 
ment de) document et creel e (sous) arbre equivalent; la serialisation redonne leffragment 
de) document d'origine (voir figure 4-4). 
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DocumentXML 

<Concert> 
<Date>J eudi 17 J anvier 2002, 20H30<Date> 
<Lieu>Chapelle des Ursules</Lieu> 
<lnterpretes> 
<lnterprete> 
<Nom>J onathan Dunford </Nom> 
<lnstrument> Basse de viole </lnstrument> 
</lnterprete> 
<lnterprete> 
<Nom> Silvia Abramowicz </Nom> 
<lnstrument> Basse de viole </lnstrument> 
</lnterprete> 
</lnterpretes> 
</Concert> 



Construction 



Date 
• 


Lie 
• 


Interpretes 
• 
Interprete Interprete 




Norn 


Instrument N 


3m Instrument 



Arbre XML du document 



Remarque 

Si Ton raisonne en terme d'arbre XML etnon pas en terme de document, il est equiva lent de dire que I'instruction 
<xsl :copy-of> provoque un duplicata recursif dun ensemble de sous-arbres :chaque nceuddu node-set est 
duplique de telle sorte qu'il soit recursivement identique au nceud original ; on obtient alors un duplicata certifie 
conforme de chacun des sous arbres ayantpourracines les nceuds originauxdu node-set de depart. 
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Deux nceuds recursivement identiques sontdeux nceuds que rien ne permetde distinguer :ils ontles meme attri- 
buts, les memes namespaces, et les memes nceuds enfants, qui sont eux-memes recursivement identiques 
deux a deux. 



Exemple trivial 



Cetexempleexplicitelaprogrammation de la serialisation (montreealafigure4-3). II est 
trivial en cesensqu'il ne fait rien de tres interessant. 



="1.0" encoding="UTF-16" standalor 



)le</Instrument> 



<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Interpretes> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Bass 
</Interprete> 

<Interprete> 

<Nom> Silvia Abr 

<Instrument>Bass 
</Interprete> 
</Interpretes> 



Concert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='xml' encoding=' ISO-8859-1 ' indent='yes' /> 

<xsl :template match="Interpretes"> 

<Musiciens> 

<xsl :copy-of select="Interprete"/> 

</Musiciens> 
</xsl :template> 

<xsl : tempi ate mat ch=" text ( )"></xsl :template> 

</xsl: stylesheet) 
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<?xml version="1.0" encoding="IS0-8859-l"?> 
<Musiciens> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 

</Interprete> 
<Interprete> 

<Nom> Silvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 

</Interprete> 
</Musiciens> 



Autre exemple 



Etant donne que instruction <xsi :copy-of> sert a dupliquer un (ou des) sous arbre(s) 
XML, il semble assez evident qu'elle sera surtout utile lors de transformations XML 
versXML. II y a neanmoins un autre cas d'utilisation assez frequent, des lors que I'on 
manipule des variables. On en verra des exemples a la section Pattern n°2 - Fonction, 
page 396. 

Dans I'exemple qui suit, il s'agit d'expurger un document XML, pour en retirer de 
I'information : 

BaseProduits.xml 

<?xml version="1.0" encoding="UCS-2" 



tandalone="yes"?> 



<refOeuvr 
<Ref v 
</refOeuv 
<Prix val 
<Prix val 
</Livre> 



lesl" NoISBN="193335" gamme="r 

ir="200001slm"/> 

= "40.5" monnaie="FF"X/Prix> 



= "5" n 



="£"/> 



<Livre 

ref="boile; 
<refOeuvre: 

<Ref valeur="liatlc.bn'7> 
</refOeuvres> 



ijacl" NoISBN="533791" gamme="roman" media="papier"> 
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<Prix valeur="30" monnaie="FF"/> 
<Prix valeur="3" monnaie="£V> 
</Livre> 

<Enregistrement 

ref="maraisl" Ref Editeur="LC000280" gamme="violedegambe" media="CD"> 
<refOeuvres> 

<Ref valeur="marais.folies"/> 
<Ref valeur="marais.piecesl685"/> 
</refOeuvres> 
<Interpretes> 

<Interprete nom="Jonathan Dunford"> 

<Role xml :lang="fr"> Basse de viole </Role> 
<Role xml :lang="en"> Bass Viol </Role> 
</Interprete> 
<Interprete nom="Syl via Abramowicz"> 

<Role xml :lang="fr"> Basse de viole </Role> 
<Role xml :lang="en"> Bass Viol </Role> 
</Interprete> 
<Interprete nom="Benjamin Perrot"> 

<Role xml :lang="fr"> Theorbe et guitare baroque </Role> 
<Role xml :1 ang="en"> Theorbo and baroque guitar </Role> 
</Interprete> 

<Interprete nom="Freddy Eichelberger"> 
<Role xml:lang="fr"> Clavecin </Role> 
<Role xml :lang="en"> Harpsichord </Role> 
</Interprete> 
</Interpretes> 

<Titre xml :lang="f r"> Les Folies d'Espagne et pieces inedites </Titre> 
<Titre xml :lang="en"> Spanish Folias and unedited music </Titre> 
<Prix valeur="140" monnaie="FF"/> 
<Prix valeur="13" monnaie="£'7> 
</Enregistrement> 

<Materiel 

ref="HarKarl" refConstructeur="XL-FZ158BK" 

gamme="lecteurCD" marque="HarKar"> 

<refCaracteristiques> 

<Ref valeur="caracHarKarl"/> 

</refCaracteristiques> 

<Prix valeur="4500" monnaie="FF"/> 

<Prix valeur="400" monnaie="£"/> 
</Materiel> 

</LesProduits> 

<!-- ... etc : le fichier continue avec d'autres elements --> 

</BaseProduits> 
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Chapitre 4 

Ce fichier XML rassemble des elements d'une base de donnees de produits, et I'on veut 
ecrireun programme XSLT permettant de creer un fichier des I ivres uniquement. 

Rien de plus simple: 

BaseProduits.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='xml' encoding=' ISO-8859-1 ' indent='yes' /> 

<xsl :template match="/"> 

I<Livres> 
<xsl :apply-templates/> 
</xsl :template> 

<xsl : tempi ate match="Livre"> 
<xsl :copy-of select="."/> 
</xsl :template> 

<xsl :template match="text( )"></xsl :template> 

</xsl:stylesheet> 

Etvoici cequ'on obtient : 



1 ivres 


xml 




<?xml 


version="1.0 


encoding="IS0-8859-l"?> 


<Livr 


es> 




<Livr 


e ref="vernes 
<refOeuvr 


" NoISBN="193335" gamme=" 




<Ref v 


leur="200001slm"/> 




</refOeuv 


es> 




<Prix val 


ur="40.5" monnaie="FF"/> 




<Prix val 


ur="5" monnaie="£"/> 




</Livre> 




<Livr 


<refOeuvr 


narcejacl" NoISBN="533791 




<Ref v 


leur="liatlc.bn'7> 




</refOeuv 


es> 




<Prix val 


ur="30" monnaie="FF"/> 




<Prix val 


ur="3" monnaie="£"/> 



" media="papier"> 



Dans I 'instruction : 

<xsl:output method='xml' encoding=' ISO-8859-1 ' indent='yes' /> 
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I 'attri but indent permet d'obtenir une indentation (pas tres convaincante, il est vrai) ; si 
on I'avaitomis, voici cequ'on auraitobtenu : 



version="1.0" encoding-" ISO-8859-1 "?> 
•esXLivre ref="vernesl" NoISBN="193335" gamme="roman" media="paf 
<refOeuvres> 

<Ref valeur="200001slm"/> 
</refOeuvres> 

<Prix valeur="40.5" monnaie="FF"/> 
<Prix valeur="5" monnaie="£"/> 
</LivreXLivre ref="boileaunarcejacl" Nol SBN=" 533791 " gamme="rc 
media="papier"> 
<refOeuvres> 

<Ref valeur="liatlc.bn"/> 
</refOeuvres> 



</LivreX/Livres> 

Au fait, pourquoi avoir integre ace programme XSLT la regie montreeci-dessous? 

<xsl :template match="text( )"></xsl :template> 

Pour voir son utilite, commencons par voir ce que I'on obtiendraitsi on la supprimait : 

BaseProduits.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='xml ' encodings ISO-8859-1 ' indent='yes' /> 

<xsl : tempi ate match="/"> 

<Livres> 

<xsl :apply-templates/> 

</Livres> 
</xsl :template> 

<xsl :template match="Li vre"> 
<xsl:copy-of select="."/> 
</xsl :template> 

</xsl:stylesheet> 

livres.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
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<Livre ref="vernesl" NoISBN=" 193335" gamme="roman" media="papier 

<refOeuvres> 

<Ref valeur="200001slm"/> 

</refOeuvres> 

<Prix valeur="40.5" monnaie="FF"/> 

<Prix valeur="5" monnaie="£"/> 
</Livre> 



</refOeuvres> 



Theorbe et guitare baroque 
Theorbo and baroque guitar 



Les Folies d'Espagne et pieces inedites 
Spanish Folias and unedited music 
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Ce fatras de textes (apres la derniere balise fermante </iivre>) et de lignes blanches 
intempestives fait reel I ement parti edu resultatobtenu ; c'estla regie par defaut 

<xsl: tempi ate match="text( )"><xsl :val ue-of select=" . VX/xsl : tempi ate> 

qui en estresponsable. 



Les instructions 
de programmation 



Les instructions de programmation sont des instructions qui permettent, soit de condi- 
tionner I'instanciation d'un modelede transformation a la valeur d'une expression boo- 
leenne, soit de manipuler des variables, des parametres, et des model es nommes (named 
templates) qui font office de ce qu'on appel lerait fonction dans des langages comme C ou 
J ava. C'est maigre, a premiere vue. Pas de boucles de repetition d'aucune sorte (on rap- 
pel I e que I 'instruction xsl:for-each n'est pas une boucle au sens algorithmique du terme, 
voir Instruction xsl:for-each, page 137), aucune possi bilite de faire evoluer la valeur 
d'une variable (adieu compteurs, incrementations, effets de bord, et toutes ces sortes de 
choses qui font partie des canons de la programmation en C) ; pas de boucle, done encore 
moins de break, et pas plus de return pour sortir prematurement d'une fonction, pardon, 
d'un modelenomme. Cote structures dedonnees, c'est encore pi re: pas de tableaux, pas 
de struct comme en C ou de ci ass comme en J ava, pas de listes, pas de hash-tables, ni 
quoi que ce soit d'autre. Ah, si ! II y en a une: la structure d'arbrede type RTF (Result 
Tree Fragment) ; mais pas de chance, c'est une WOM (Write Only Memory) : on peuty 
ranger des elements, mais on nepeutlesy retrouver individuellement... 

Dans ces conditions, comment peut-on encore vouloir programmer quoi que ce soit avec 
un tel langage? A utant vouloir percer un muravec un tire-bouchon. 

Etpourtant... Lecroirez-vous? XSLT estun langage Turing-complet, comme disent les 

savants. 

Alan Turing etait un mathematicien anglais, qui dans les annees 1936-1937, a fonde la 

theorie de la calculabilite (qui a pour objet de savoir si toute fonction est calculable, ce 

qu'est une fonction calculable, etc.). II adefini ce qu'on appel I eaujourd'hui une machine 

deTuring, qui, par definition de la calculabilite, peutcalculer tout ce qui est calculable en 



Les instructions de programmation 



un nombre fini cooperations. Un langageTuring-complet est un langageavec lequel on 

peut programmer tout cequ'une machine de Turing peut calculer, c'est-a-diretout... ce 

qui est calculable. 

On adu mal alecroire, apresle resume des prouessesde XSLT en la matiere. Maisc'est 

pourtantvrai. 

En effet, les model es nommes (ou fonctions) peuvent etre appeles recursivement ; il y a 
la possi bilite de tester une condition avec I'instruction xsi:if ; enfin on peut se 
debroui Her pour bricoler une structure de tableau, en la construisant comme un arbre, que 
I'on convertitensuiteen chaine de caracteres, I'acces aux elements sefaisant en I'explo- 
rant grace aux fonctions XPath predefines (notamment substring, substring-after, 
substring-before). Or, il estconnu qu'on peut tout programmer en disposantseulement 
de tableaux, de la recursion, et de tests. C'est done vrai qu'on peut tout programmer en 
XSLT. M ais il est evidemment hors de question de programmer quoi que soit dans ces 
conditions: c'esttotalement inutilisable en pratique, sauf eventuel I ement pour destraite- 
ments extremement simples. 

Heureusement, dans la realite, la situation est un peu meilleure : en effet, la plupart des 
processeurs XSLT disponibles offrent une extension sous forme d'une fonction de 
conversion, qui permet de convertir le type RTF en vrai node-set ; du coup, on peut lui 
appliquer n'importe quelle expression XPath, et done extraire nominativement et com- 
modement toute information individuelle qui s'y trouve. 

Cela change enormement la puissance du langage en terme de programmation, car on 
peut des lors construire des structures de donnees aussi complexes que I'on veut (et pour 
cela, un arbre n'est pas un mauvais choix), et recuperer les informations stockees sans 
difficult particuliere. 

De plus, ce qui pour I'instant (par rapport a XSLT 1.0) est une extension indispensable, 
devrait bientot devenir une extension inutile : en effet, la prochaine version de XSLT 
(XSLT 2.0) prevoitd'unifier les notions de RTF et de node-set, rendantainsi caduquela 
fonction deconversion RTF vers node-set. 



Note 

II existe une version intermediaire, XSLT 1.1, mais qui est et restera sous forme de Working Draft : il n'y aura 
jamais de Recommendation XSLT 1.1, parce les evolutions prevues parle Working Draft 1.1 ne sontpas mi- 
neures, et risquent de restreindre le champ d'investigation des travaux sur la 2.0, tant que ces derniers ne seront 
pas suffisammentavances pourqu'il soit possible de comprendre finementles implications de I'heritage impose 
par un Working Draft 1. 1 promu au rang de Recommendation. Les travaux sur le Working Draft 1.1 ont done ete 
interrompus, etles propositions devolution qu'il prevoyaitontete incorporees aux propositions devolution pour 
la 2.0. 

Ceci dit, il reste vrai que la programmation en XSLT n'est pas une chose tres aisee, 
d'abord parce que c'est une programmation fonctionnelle pure, done assez etrangere, en 
general, a ce qui nous est familier ; ensuite parce que le langage est extremement spar- 
tiate (on peut difficilement imaginer un langage plus minimaliste) ; enfin parce que la 



Instruction xshif 



Chapitre 5 

bibliotheque de fonctions predefines n'est pas tres developpee (encore que cela puisse 
evoluer dans les prochaines versions). 

Audemeurant, il fautresterconscientqueXSLT n'est pas un langageconcu pourfairede 
I'algorithmique, mais pour faire des transformations d'arbres XML, chose qu'il fait 
extremement bien, reconnaissons-le (a tel point que lorsqu'on a un stock de donnees 
informelles a traiter, quelles qu'elles soient, se pose desormais la question de savoir s'il 
ne vaudrait pas mieux commencer par structurer ses donnees en XM L, puis de les sou- 
mettre a une transformation XSLT, plutot que d'ecrire un programme ad-hoc en C ou 
Java). II faut done plutot voir les possibi I itesdeprogrammationcomme des complements 
a la manipulation et la transformation d'arbres XM L, et sous cet angle, il est incontes- 
table que ces complements decuplent la puissance du langage de transformation. 

Instruction xshif 

Bande-annonce 

<xsl :template match="Compositeurs"> 

<H3 align="center"> Oeuvres de <br/> <xsl :apply-templ ates/> </H3> 
</xsl :template> 

<xsl :template match="Compositeur"> 

<xsl:value-of select="."/> 

<xsl:if test="not(position() = last())">, </xsl:1f> 
</xsl :template> 

Cet exemple montre une instanciation conditionnelle d'une partie d'un modele de trans- 
formation : unevirguleestajouteeala valeur textuelle du nceud courant, sauf si e'est le 
dernier de la liste constitute par <xsi :appiy-tempiates/>. On obtient ainsi une liste 
d' items separes par des virgules. 



Syntaxe 



;l:if test=" ... expression XPath ... 
<!-- modele de transformation --> 
... texte ou instructions XSLT ... 
<!-- fin du modele de transformatior 



L'instruction xsi :if nedoit pas apparaltreen tant qu'instruction de premier niveau. 

Regie XSLT typique 

Une regie XSLT uti I isant I 'instruction xsi :if sera souvent employee commececi : 
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;!-- modele de transformation -- 
.. texte ou instructions XSLT . 
:!-- fin du modele de transforme 



Semantique 



L'expression XPath fournieen tantquevaleur de I 'attri but test estevaluee, et sa valeur 
est eventuellement convertie en booleen s'il le faut, en lui appliquant la fonction 
booieano. Rappelons (voir sectionboolean true(), page 636) que cette fonction renvoie 
true si et seulement si son argument est un nombre non nul, ou une String de longueur 
non nulle, ou un node-set non vide. 

Si la valeur de I'attribut test est egale a true, le modele de transformation associe est 
instancie; sinon, il nel'estpas. 

II n'y a pas de else possible, allant de pair avec lexsiMf ; si I'on veut une alternative a 
deux branches, il faut utiliser I 'instruction xsi :choose. 



Exemple 

N ous reprenons notre fichier XML d'annonce de concert : 
Concert.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?: 



<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 



<Ensemble> "A deu> 



viole 



</Ensemble: 



<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 

</Interprete> 
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<TitreConcert> 

Folies d'Espagne et diminutions d'ltali 
</TitreConcert> 

<Compositeurs> 

<Compositeur>M. Marais</Compositeur> 
<Compositeur>D. Castel lo</Compositeur> 
<Compositeur>F. Rognoni</Compositeur> 

</Compositeurs> 



Comme dans le tout premier exemple vu, (voir figure 3-1), nous cherchons a en faire une 
page HTML, avec les compositeurs presentes sous la forme d'une liste de noms separes 
par unevirgule. 

M ais la difficult est ici que les virgules ne sont pas fournies dans le texte du fichier 
XML. C 'est done la feuillede style XSL qui va devoir en insereruneapreschaquenom, 
sauf apres le dernier (a" oil I 'intervention d'une instruction xsi : if pour tester cette condi- 
tion). 

Comment exprimer la condition ? II fautconstituer un node-set contenant les Composi- 
teur^ sachant que le dernier repondraau test positiono = lasto. 

Voyons ce que cela donne si nous ecrivons une regie dont le motif concorde avec 

<Compositeur> : 

<xsl :template match="Compositeur"> 

</xsl :template> 

Supposons que le noeud courant soit par exemple le <compositeur> D. Castel I o, et que 

I 'algorithme de recherche de concordance se lance ; il va determiner que le motif de cette 
regie concorde avec le noeud courant, parce qu'en prenant le noeud parent composi- 
teur comme noeud contexte, et en evaluant I'expression XPath "child:: compo- 
siteur", on obtient un node-set detrois elements compositeur^ qui contient le noeud 
courant. Dans ce node-set, le noeud courant a la position 2, letestpositiono = lasto 
devrait done repondre fai se. 

II semble done que cela devrait pouvoir marcher ; neanmoins si on essaye, on constate 
que ce n'est pas le cas. E n cherchant un peu, on finit par determiner que les trois elements 
<compositeur>n'ont pas comme position (dans le node-set dont il estquestionci-dessus) 
1, 2, et 3, mais2, 4, 6. C'estdii a ce que I'element compositeur n'a pas trois enfants 
directs, maissept: 

• un premier enfant de type text ne contenant que des espaces, tabulations ou fins de 
ligne; 



Un deuxieme enfant de type element, <Compositeur>M. Man 
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• un troisieme enfant de type text ne contenant que des espaces, tabulations ou fins de 
ligne; 

• Un quatrieme enfant de type element, <Compositeur>D. Castello</Compositeur> ; 

• un cinquieme enfant de type text ne contenant que des espaces, tabulations ou finsde 
ligne; 

• Un Sixiemeenfantdetype element, <Compositeur>F. Rognoni</Compositeur> ; 

• un septieme enfant de type text ne contenant que des espaces, tabulations ou fins de 
ligne. 

Note 

Revoir a ce sujet la section Exemple d'arbre XML d'un document, page 38. 

La solution, pour retabli rune numerotati on pi us conformed I 'intuition, est bien siird'eli- 
miner ces nceuds « parasites » de type texto, ce que I'on fait grace a I'instruction 

<xsl :strip-space el ement="Composi teurs"> . 



On aboutit alors a la feuille de style suivante : 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns:xsl="http: //www. w3.org/1999/XSL/Transforn 
<xsl:output method='htmr encodings ISO-8859-1 ' /> 



<xs 


:strip-space elements='Composi 


eurs' 


/> 








<xs 


rtemplate match="/"> 
















<html> 
















<head> 
















<title><xsl: value 


-of s 


lect= 


"/Cone 


ert/Entete 


/></t 


tle> 




</head> 
















<body bgcolor="white' 


text 


"blac 


k"> 










<xsl :apply-templa 


tes/> 














</body> 
















</html> 














</x 


1 :template> 














<xs 


:template match="Entete"> 
















<p> <xsl:value-of select= 


"."/> 


presentent </p> 






</x 


1 :template> 















<xsl :template match="Date"> 

<H1 align="center"> Concert du <xsl : value-of select=" 
</xsl :template> 

<xsl :template match="l_ieu"> 
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<H4 align="center"> <xsl :val ue-of select="."/> </H4> 
</xsl :template> 

<xsl :template match="Ensemble"> 

<H2 align="center"> Ensemble <xsl :val ue-of select=" . "/></H2> 
</xsl :template> 

<xsl :template match="Compositeurs"> 

<H3 align="center"> Oeuvres de <br/> <xsl :apply-templ ates/> </H3> 
</xsl :template> 

<xsl :template match="Compositeur"> 

<xsl:val ue-of select="."/> 

<xsl:if test="not(position() = last())">, </xsl:if> 
</xsl :template> 

<xsl : tempi ate match="text()"/> 

</xsl: stylesheet) 

Lemodelede transformation associe a ^instruction xsi :if n'est instance que pour les 
elements dont la position (dans le node-set calcule lors de la recherche de concordance) 
n'est pas la derniere. 

Remarquons aussi la derniere regie, vide, qui remplace la regie par defaut s'appliquant 
aux textes, ceci afin d'eviter la presence dans le resultat des nceuds ignores par cette 
feuillede style, notamment<Nom> et<instmment>. 

Le resultat obtenu est lesuivant (voir aussi la figure 5-1) : 

Concert.html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title> Les Concerts d’Anacréon </title> 
</head> 
<body bgcolor="white" text="black"> 

<p> Les Concerts d’Anacréon présentent </p> 

<H1 align="center"> Concert du Jeudi 17 Janvier 2002, 20H30</H1> 

<H4 align="center">Chapelle des Ursules</H4> 

<H2 align="center"> Ensemble «A deux violes esgales» </H2> 

<H3 align="center"> Oeuvres de <br>M. Marais, D. Castello, F. Rognoni 

</H3> 
</body> 
</html> 

Terminons en indiquant qu'il n'etait peut-etre pas necessaire de trier les elements pour 
lesquels on elimine les enfants de type text( ) ne contenant que des espaces blancs (i.e. 
un espace, une tabulation, un retour ligneou un sautde ligne). Si I 'on veutelaguer par- 
tout, On ecrira plutot : <xsl :strip-space element="*">. 
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Figure 5-1 

Listedenomsse'pare's 
par desvirgules. 



s Netscape: Les Concerts d'Anacreon W 



3 r& & Li 



Concert du Jeudi 17 Janvier 
2002, 20H30 

Chapelle des Ursules 

Ensemble «A deux violes esgales» 

Oeuvres de 
M. Marais, D. Caste llo, F. Rognoni 
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Bande-annonce 

<xsl :choose> 



<xsl :when test="count( ./Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl :when test="count( ./Interprete) = 2 "> 

<xsl:value-of select="Interprete[l]"/> et <xsl 
select="Interprete[2]"/> 
</xsl :when> 



<xsl :for-each select="Interprete"> 

<xsl:value-of select=" . "/Xxsl :if test="not(positioi 
last())">, </xsl:if> 
</xsl :for-each> 
;1 :otherwise> 
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Cet exemple montre une instanciation conditionnelle de plusieurs fragments de modeles 
de transformation. Le but est d'obtenir trois formes possibles d'enumeration, suivant le 
nombre d'elements a enumerer : 

• xxx : dans le cas ou il n'y a qu'un seul element ; 

• xxx et xxx : dans I e cas ou i I y a deux el ements ; 

• xxx, xxx, xxx : dans le cas ou il n'y a plus de deux elements. 



Syntaxe 



xsl :choose 

<xsl :choose 



<!-- autant de xsl:when que l'or 

<xsl:when test=" ... expression 
<!-- modele de transformation -- 
... texte ou instructions XSLT . 
<!-- fin du modele de transforms 
</xsl :when> 

<xsl:when test=" ... expression 
<!-- modele de transformation -- 
... texte ou instructions XSLT . 
<!-- fin du modele de transforms 
</xsl :when> 



<!-- 1 'element > 






;st facultatif - 



<xsl :otherwise> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 

</xsl:otherwise> 

</xsl :choose> 

L'instruction xsl :choose nedoitpasapparaitreen tantqu'instruction de premier niveau. 



Regie XSLT typique 

UneregleXSLT uti I isant l'instruction xsi :choose sera souvent employee commececi : 
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<xsl:when test=" ... expression XPath ... "> 

<!-- modele de transformation --> 

... texte ou instructions XSLT ... 

<!-- fin du modele de transformation --> 

</xsl:when> 

<xs1: otherwise) 

<!-- modele de transformation --> 
... texte ou instructions XSLT ... 
<!-- fin du modele de transformation --> 
</xsl :otherwise> 

</xsl:choose> 
/xsl :template> 

C'est I'equivalent du if avec sesdeux branches then etelse. 



Semantique 



C'est une instruction qui instancieau plus un modele de transformation. Les expressions 
XPath des differents elements xsi -when sont evaluees en sequence; des que I'une est 
vraie, le modele de transformation associe est instance ; si aucune n'est vraie, et si un 
element xsi : otherwise est present, son modele de transformation associe est instancie. 
Si aucune n'est vraie, ets'il n'y a pasd'elementxsi : otherwise, aucun modele de trans- 
formation n'est instancie. 

II n'est done pas necessaire que les conditions exprimees soient mutuellement exclu- 
sives: memesi plusieurssontvraies, seulela premiere d'entreellesentrainera I'instan- 
ciation du modele associe. 



Exemple 

ProgrammeConcert.xml 



="1.0" encoding="UTF-8" standalc 



<ProgrammeConcert> 
<PageTitre> 



<Entete> 

"Les Concerts d'Anacreon" 

<Date>Samedi 9 octobre 1999, 20H30</Date> 

<Lieu>Chapelle des Ursules</Lieu> 

</Entete> 



<Ensemble> 
<Nom> 



La Cetra d'Orfeo 
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</Nom> 

<Di recti on> 

Michel Keustermans 
</Di recti on> 
</Ensemble> 

<Interpretes> 
<Role> 

<Interprete> Yvan Goossens </Interprete> 
</Role> 
<Role> 

basse 

<Interprete> Conor Biggs </Interprete> 
</Role> 
<Role> 

flute a bee 

<Interprete> Michel Keustermans </Interprete> 

<Interprete> Laura Pok </Interprete> 
</Role> 
<Role> 

viole d'amour 

<Interprete> Vinciane Baudhuin </Interprete> 
</Role> 
<Role> 

oboe da caccia 

<Interprete> Blai Justo </Interprete> 
</Role> 
<Role> 

viole de gambe 

<Interprete> Rika Murata </Interprete> 

<Interprete> Martin Bauer </Interprete> 

<Interprete> Sophie Wati 11 on </Interprete> 
</Role> 
<Role> 

violone 

<Interprete> Benoit vanden Bemden </Interprete> 
</Role> 
<Role> 

orgue positif et clavecin 

<Interprete> Jacques Willemijns </Interprete> 
</Role> 
</Interpretes> 

<TitreConcert> 

Cantates allemandes 
</TitreConcert> 

<Compositeurs> 

<Compositeur> Bach </Compositeur> 
<Compositeur> Telemann </Compositeur> 
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I</Compositeurs> 
</PageTitre> 
</ProgrammeConcert> 

Nous supposons ici que nous voulons sortir uniquement les noms des musiciens, classes 
par instruments; de plus, s'il y a deux musiciens pour un instrument donne, les noms 
seront separes par « et », mais s'il y en a trois ou plus, Ms sortiront separes par des vir- 
gules. 

II est done necessaire, ici, de compter le nombred'elementsd'un node-set: cela sefait 
tresbien gracealafonctionXPath counto. 

Void une premiere version de la feuillede style: 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="l .0"> 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl :template match="Role"> 

<xsl:value-of select=" ./child: :text( )"/> : 



<xsl:choc 



<xsl :when test="count( ./Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl:when> 

<xsl:when test="count( ./Interprete) = 2 "> 
<xsl:value-of select="Interprete[l]"/> e 
select="Interprete[2]"/> 
</xsl :when> 



<xsl :for-each select="Interprete"> 

<xsl:value-of select=" . "/Xxsl :if test="not(positior 
last())">, </xsl:if> 
</xsl :for-each> 
</xsl :otherwise> 

</xsl:choose> 

</xsl :template> 

<xsl :template match="text( )"/> 

</xsl: stylesheet) 
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Pour un element <Roie>donne, on commence par ecri re lenom del 'instrument, recupere 
en tant que valeur du nceud de type text, enfant direct du <Roie> courant. Ensuite, le 
<xsi :choose> permet de discriminer trois cas possibles : un seul interprets ou deux, ou 
plus (xsi otherwise correspond a trois ou plus, parcequ'i I n'y a jamais aucun interpreted 

On remarquera I'utilisation de I'expression XPath interpreted] , qui est la forme 

COUrtedechild::Interprete[position()=l] . 



Voici cequ'on obtient : 



Resultat 


flute a bee 








Michel Keustermans et Laur 
viole d'amour 


a Pok 






Vinciane Baudhuin 

oboe da caccia 








Blai Justo 

viole de gambe 








Rika Murata , Martin Bauer 
violone 


, Sophie 


Wati 




Benoit vanden Bemden 

orgue positif et cl av 


ecin 





1 1 y a clairement un probleme de repartition des espaces blancs, mais ce type de probleme 
survi ent necessai rement des que I 'on declare une sortie en mode text, comme dans I e cas 
present. 

Le moment n'est pas encore venu d'etudier d'une facon generale les problemes d'es- 
paces blancs en XSLT, nous verrons cela dans le chapitre consacre a instruction 
xsi:text (voir Instruction xsktext, page250), ou nous continuerons I'etude de cet 
exemple afin de rendre le resultat presentable. 

Instruction xshvariable 

Une variable, en XSLT comme dans tout autre langage, est I 'association d'un nom et 
d'une valeur. Neanmoins, en XSLT, cette association est indestructible: il est impossible 
de changer la valeur d'une variable, une fois qu'on I'a determinee. Nous I'avons deja 
signale plusieurs fois, mais i I est important derappelerici que le langage XSLT estun lan- 
gage fonctionnel pur (mais pas complet, dans la mesureouil ne permet pas demanipuler 
les fonctions comme des donnees), done sans affectation ni effet de bord. En parti cu- 
lier, les fonctions (qu'elles soient predefinies ou definies explicitement sous forme de 
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modeles nommes) sontdesfonctions qui nemodifienten aucunefacon I'etatdu proces- 
sus XSLT. 

En XSLT, il est interdit de declarer plusieursfois la meme variable (il en est de meme 
dans la plupart des langages), et la seule instruction permettant d'affecter une valeur 
a une variable n'est autre que sa declaration ; la conclusion tombe d'elle-meme : les 
variables ne peuvent pas changer de valeur. 

instruction xsi :• 



declaration et initialisation. 



able decritedans cette section est precisement cell e qui combine 



Bande-annonce 



ne="nombreInterpretes" select="count( ./Interpreter /> 



<xsl :when test="$nombreInterpretes = 1 ") 

<xsl :value-of select="Interprete"/> 
</xsl :when> 



<xs 


:when test 


="$nombreInterpretes = 2 


> 






<xsl :value 


-of sel 


a ct="Interprete[l] 


/> et 


<xsl:v 






sel 


ct="Interprete[2] 


/> 




</x 


1 :when> 










<xs 


: otherwise 












<xsl:for-e 


ach sel 


ct="Interprete"> 








<xsl:v 


alue-of 


select=".'7Xxsl: 
last())">, </xsl: 


f test 
f> 


="not( 




</xsl:for- 


sach> 








</x 


1 :otherwise> 








</xsl :choose> 











Cet exemple montre I 'initialisation d'une variable (nombreinterpretes), et son utilisa- 
tion par appel de Sa valeur ($nombreInterpretes). 

Une variable peutaussi etreinitialisee par instanciation d'un modelede transformation 
litteral, commececi : 



<xs 


variable 

<RDC> 

<cuisi 
Ev 
</cuis 
<WC> 


e surfa 
ne> 


ison"> 

ce='12m2'> 
. Mobil ier 


encastre 








La 


abo. Cumulus 200L 










</WC> 














<sejou 


surfac 


e='40m2'> 










Cheminee e 


n pierre. 


Poutres a 


Pi 


fond 




Ca 


relage 


terre cult 


e. Grande 


bai 


5 vit 
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</sejour> 

<bureau surface='15m2'> 

Bibliotheque encastree. 
</bureau> 
<jardin surface=' 150m2'> 

Palmier en zinc figurant le desert. 
</jardin> 
<garage/> 
</RDC> 
</xsl:variable> 

Le model ede transformation peuttres bien etrecalcule (etdonc nepasetreentierement 
litteral) : 



insert> 

<Ensemble> 

<NomXxsl:va" 
<Direction><; 

</Ensemble> 

<Concert> 

<DateXxsl:v, 
<VilleXxslM 
<LieuXxsl:v, 
<TitreXxslM 

</Concert> 
'insert> 



>-of select="Date"/X/Date> 

ae-of select="Ville'7X/Ville> 

3-of select="Salle'7X/Lieu> 

je-of select="TitreConcert'7X/Titre> 



Syntaxe 



xsl :variable 

<xsl :variable nair 



select=" ... expression XPath ... "/> 



A utre possibilite : 
xsl :variable 

<!-- modele de transformation --> 
... texte on instructions XSLT ... 
<!-- fin du modele de transformatic 
</xsl:variable> 



L'instruction xsi : variable peut aussi apparaitre comme instruction de premier niveau. 



Regie XSLT typique 

Typiquement, les instructions xsi:variabie seront reparties a volonte dans le pro- 
gramme XSLT comme ceci : 
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<?xml version="1.0" encoding="UCS-2"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="l.C 



;ncoding='IS0-8859-l' /> 
;elect='...' /> 



I :template match=' 



</xsl:stylesheet> 

En effet, une instruction xsi :variabie peut apparaitre a peu pres n'importe ou dans un 
programme XSLT ; on peut meme la trouver comme enfant direct de I 'element racine 
<xsi :styiesneet> (dans ce cas, c'est une instruction de premier niveau). Cela ne veut 
pas dire qu'une variable est necessai rement visible (ou utilisable) partout; il y a des 
regies de visibility, comme en C oujava (voir Regies de visibility page 212). 



Semantique 



En tantqu' instruction XSLT, ^instruction xsi variable peut apparaitre dans un modele 
de transformation associea une regie (voir ci-dessus, Regie XSLT typique, page 181), ce 
qui faitqu'il y a en general deux model esde transformation adistinguer : un propreala 
variable el I e-meme, etun propreala regie XSLT considered : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl :template match="..."> 

<!-- modele de transformation propre a la regie --> 



- modele de transformation propre a la v 

- fin du modele de transformation propre 
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<!-- fin du modele de transformation propre a 1 
</xsl :template> 



</xsl: stylesheet) 



Lorsque le modele de transformation de la regie est instance, I 'instruction <xsi :varia- 
bie>...</xsi :variabie> ou <xsi variable .../> est remplacee par ri en (c'est-a-dire 
est supprimee : rien est la valeur de remplacement). Cela ne veut pas dire qu'elle est 
ignoree ; cela veut seulement dire que sa contribution au texte produit dans le fragment 
de resultat, lors de cette instanciation, est n u 1 1 e : levrai travail se fait en coulisse. 

En effet, la semantiquede devaluation del 'instruction xsi variable est cell e del' atta- 
chement d'une valeur a un nom. La valeur est elle-meme I'association d'une donnee et 
d'un type qui permetd' interpreter la donnee. Par exemple la donnee 387 sera interpret.ee 
comme la valeur true si le type est booleen, comme la valeur numerique 387 si le type est 
Number, et comme la suite de caracteres 3,8,7 si le type est String. La variable prend 
dynamiquement son type d'apres celui de la valeur recue: il n'y a pas dety page stati que 
comme en C oujava. 

La valeur peut etre obtenuede deux manieres : 

• soit c'est le resultat de devaluation d'une expression X Path fournie en tant qu'attribut 
select. Rappelons (voir XPath, un langage d 'expressions, page 40) qu'il y a quatre 
types de valeurs possibles pour une telle expression : String, Number, Boolean, et 
Node- set. 

Danscecas, I 'element <xsl : variable name=". . . " select=". . ."/> doit etre vide (si 

labalisedefermeture<xsi : variable ...> estpresente, il ne doit rien y avoir d'autre 
qued'eventuelsespacesblancsentre<xsi : variable ...> et</xsi :variabie>). 

• soit c'est un arbre XML, resultat de I 'instanciation du modele de transformation 

propre a I'inStrUCtion <xsl : variable name=". ..">. 

Dans ce cas, I'attribut sei ect=" . . . " ne doit pas etre fourni . 

Untel arbre XML s'appelleunTST (Temporary Source Tree), et I e type del a variable 
est alors soit node-set en XSLT 1.1 ou plus, soit RTF (Result Tree Fragment) en 
XSLT 1.0. 

Rappelons quecette instanciation se produitlorsde I'instanciation du modelede trans- 
formation dans lequel la variable est immergee, si c'est une variable locale ; si c'est 
unevariableglobale, I'instanciation se produitjuste avant la premiereetape (voirTrai- 

tementdu document XML source, page 87) du modele detraitement. 

La premiere possibi lite ne pose pas de probl erne parti culier : avec les expressions XPath, 
on est en terrain connu. Par contre, avec la deuxieme, nous voici confronted a une notion 
nouvelle: qu'est-cequ'un Temporary Source Tree, etquepeut-on en faire? 

Avant de repondre a ces questions, nous allons d'abord voir quelques exemples d' utilisa- 
tion d'une variable dont la valeur provient d'une expression X Path. 
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Variables globales et locales 

Comme beaucoup d'autres langages de programmation, XSLT fait la difference entre 
variable globaleet variable locale. Une variable locale est une variable definie a I'inte- 
rieur d'un modele de transformation, alors qu'une variable globale est une variable 
definie a I'exterieur d'une regie XSLT, en tant qu'elementXML enfant direct de I'ele- 

ment<xsl :stylesheet>. 

En regie general e, dans les langages traditionnels, les variables globales n'ont pas bonne 
reputation ; on recommandetoujoursd'en eviter I'usage, car ellerendentplus difficilesla 
maintenance et la comprehension des programmes. C'est du a une raison tres simple : 
une variable globale peut etre affectee depuis n'importe quel endroitdu programme, ren- 
dant ainsi tres complexes les relations et les roles qui s'etablissent entre les differentes 
parties du programme qui mettentajour cette variable. 

En XSLT, plusrien de tout 5a, puisque les variables ne sont pas modifiables : il n'y a pas 
a" inconvenient parti culier a declarer des variables globales. 

Utilisation d'une variable 

Referencer une variable de nom x, c'est obtenir la valeur attachee au nom x ; cela se fait 
en ecrivant $x. 

Note 

L'expression $x peut etre vue comme I'application de I'operateurtfau nom x, renvoyantla valeur de x.Toutefois, 
cette interpretation s'eloigne de la grammaire XSLT, car$n'estpas un opera teur, etdans I'ecriture $x, un espace 
n'estpas autorise entre le $etle x. 

Dans une expression XPath 

U ne reference de variable peut apparaitre dans une expression X Path, partout oil apparait 
une so us- expression renvoyant I'un des types de base en XPath, c'est-a-dire Number, 
String, Boolean, et Node-set. 

L e seul probleme que I 'on puisse rencontrer pour mettre en pratique cette affirmation, est 
celui du decoupage d'une expression en sous-expressions. 

Plus precisement, si I'on construit une expression qui ne manipule que des Number, 
String ou Boolean, il n'y a aucun probleme : on est dans une situation familiere, iden- 
tique a celle des autres langages courants. On peut utiliser une variable la ou intuiti- 
vement, on en utiliserait une dans un langage comme C ou J ava : 

... select="string-length( concat( Sbefore, $after ) ) - SnbSepar" ... 

Les difficult.es surviennent avec les expressions renvoyant un node-set : ces expressions 
sont construites a base de chemi ns de local isation, et la question qui se pose est de savoi r si 
un chemi n de localisation est une expression qui peut se decomposer en so us- expressions. 
Si oui, chaque sous-expression peut alors etre remplacee par une reference de variable 
renvoyant la meme valeur. 
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Chapitre 5 

II y adejaun premier element de reponse assez evident : chaquepredicat est une expres- 
sion booleenne, elle-meme decomposable en sous-expressions : toutes ces expressions 
sontremplacables par une reference de variable. 

En dehors despredi cats, il n'y aqu'un seul element, dansun chemin de localisation, qui 
peut etre remplace par une valeur, c'est I 'amorce, qui fournit le node-set des nceuds- 
contexte(voir Chemins de localisation, page 62). L'expression ci-dessous est done syn- 
taxiquementcorrecte: 

$amorce/child::Interprete/child: :Nom 

et pour qu'elle soit semantiquement correcte, il suffit que la variable amorce soit du type 
node-set, autrement dit que la reference a cette variable renvoie un node-set. 

Ailleurs (en dehors des predicats), il est impossible de faire figurer une reference de 
variable, car une etape de localisation n'est pas une expression, un axe de localisation 
n'estpas une expression, un determinant n'est pas une expression. 

Tout processeur XSLT doit done refuser (des la decouverte du caractere '$') les expres- 
sions suivantes: 

/SnomAxe: : Interprete/child: :Nom <!-- faux ! --> 
/child: :$nomElement/chi Id: :Nom <!-- faux ! --> 

Dans un motif 

Une reference de variable ne peut jamais intervenir dans un motif, e'est-a-dire dans 
l'expression XPath fournie en tant que valeur de I'attribut match de instruction 
xsi template (I 'instruction xsi : key utilise aussi un motif, de meme que instruction 
xsi : number ; ce sont les trois seuls endroits d'un programme XSLT ou un motif peut 
intervenir, et dans ces trois cas, une reference de variable est interdite). 
La raison estquecela pourrait introduire une circularite entre la definition de variable et 
I 'evaluation du motif ; on verra cela plus en detail a la section Regies de visibility pour 
les variables globales, page 212. 

Exemple d'utilisation d'une variable 

Reprenons le programme XSLT vu pour I'instruction xsi:choose (voir Exemple, 
page 176). 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xs1:output method='text' encoding=' ISO-8859-1' /> 

<xsl : tempi ate match="Role"> 

*<xsl:value-of select="normal ize-space( ./child: :text( ) )"/> : 
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<xsl :when test="count( ./Interprete) = 1 "> 

<xsl :value-of select="Interprete'7> 
</xsl :when> 

<xsl:when test="count( ./Interprete) = 2 "> 
<xsl:value-of select="Interprete[l]"/> t 
select="Interprete[2]"/> 
</xsl :when> 





<xsl 


:otherwise> 
<xsl:for-each s 
<xsl:value- 

</xsl :for-each> 




</xs 


1 :otherwise> 




</xsl:ch 


oose> 


</xs 


1: te.pl a 


te> 


<xsl 


:templ at 


e match="text() 



ect="Interprete"> 

' select="."/Xxsl:if test="not(position( ) = 



7xsl: stylesheet) 

N ous pourrions reecrire ce programme comme ceci : 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="l.C 

<xsl:output method='text' encodings' ISO-8859-1 ' /> 

<xsl :template match="Role"> 

*<xsl:value-of select="normal ize-space( ./child: :text( ) )"/> : 

<xsl :variable name="nombreInterpretes" select="count( ./Interprete)" / 

<xsl :choose> 

<xsl :when test="$nombreInterpretes = 1 "> 

<xsl :value-of select="Interprete'7> 
</xsl:when> 

<xsl :when test="$nombreInterpretes = 2 "> 

<xsl:value-of select="Interprete[l]"/> et <xsl :val ue-of 
select="Interprete[2]"/> 
</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl:value-of select="."/Xxsl :if test="not(position( ) = 
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</xsl : tempi ate> 
<xsl: tempi ate match="text( )"/> 
</xsl: stylesheet) 

La variable nombrel nterpr<?tes est une variable locale, qui n'apporte pas grand-chose au 
programme, i I estvrai,etantdonnesa simplicity Maisonentrevoittoutdememel'interet 
qu'il peuty avoir a utiliser une variable au lieu d'une valeur dans une expression : c'est 
d'apporter un confort de lecture appreciable, notamment quand I'expression qui lui a 
donne sa valeur est compl iquee, et que le nom de la variable est suffisamment semantique 
pour edairer la signification de I'expression en question (il fautici serappelerquecequi 
coute cher, ce n'est pas d'ecrire un programme, mais de le maintenir ; or le maintenir, 
c'est constamment I e rel i re ; c'est pourquoi i I est preferabl e d'opti mi ser I a faci I i te de I ec- 
tured'un programme, qued'en optimiser lafacilite d'ecriture). 

1 1 y a par contre un cas ou une variable est necessaire, c'est celui ou on veut manipuler un 
TST, puisque par definition, I'existence d'un TST implique celle d'un modele de trans- 
formation associe a une variable. 

Evaluation d'une variable globale 

La declaration d'une variable necessite en general devaluation d'au moins une expres- 
sion X Path, contenue dans I 'attribut sei ect de la declaration, ou contenue dans le modele 
de transformation associe a la variable si sa valeur est un TST. Or, on sait qu'une expres- 
sionXPath nepeutgeneralementpasetreevalueedansl'absolu : il fautun nceud contexte 
et une liste contexte (pour une variable locale, il n'y a pas de probleme, puisqu'elle est 
declaree dans un modele de transformation, qui est toujours instancie relativement a un 
nceud contexte et une liste contexte). 

La regie est done qu'une variable globale est evaluee relativement a un nceud contexte 
qui est le nceud racinedel'arbreXM L du document, etavec une liste contexte qui est la 
liste ne contenant que ce nceud. 

Exemple 

Danscetexemple, on disposed'un extraitXM Lise d'une base dedonnees produits (cata- 
logue) : 

BaseProduits.xml 

<?xml version="1.0" encoding="UCS-2" standalone="yes"?> 
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<BaseProduits> 
<LesProduits> 

<Livre ref="vernesl" NoISBN="193335" gamme="roman" media="papier"> 

<refOeuvre> 

<Ref valeur="200001slm"/> 

</refOeuvre> 

<Prix valeur="40.5" monnaie="FF"/> 

<Prix valeur="5" monnaie="£"/> 
</Livre> 

<Livre ref="boileaunarcejacl" NoISBN="533791" gamme="roman" media-"papi£ 

<refOeuvre> 

<Ref valeur="liatlc.bn"/> 

</refOeuvre> 

<Prix valeur="30" monnaie="FF"/> 

<Prix valeur="3" monnaie="£"/> 
</Livre> 

<Enregistrement ref="maraisl" Ref Editeur="LC000280" 

gamme="violedegambe" media="CD"> 
... sans interet pour 1'exemple 
</Enregistrement> 

<Materiel ref="HarKarl" refConstructeur="XL-FZ158BK" gamme="lecteurCD" 

marque="HarKar"> 
... sans interet pour 1'exemple 
</Materiel> 

<Livre ref="phbeaussantl" NoISBN="138301" gamme="essai " media="papier"> 

<refOeuvre> 

<Ref valeur="vadb.phb"/> 

</refOeuvre> 

<Prix valeur="60" monnaie="FF"/> 

<Prix valeur="8" monnaie="£'7> 
</Livre> 

</LesProduits> 

<LesOeuvres> 

<0euvre ref="200001slm"> 

<Titre> Vingt mi 11 e lieues sous les mers </Titre> 
<refAuteurs> 

<Ref valeur="JVernes"/> 
</refAuteurs> 
</0euvre> 
<0euvre ref="marais.fol ies"> 

<Titre> Les Folies d'Espagne </Titre> 
<refAuteurs> 

<Ref valeur="MMarais"/> 
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</refAuteurs> 
</0euvre> 
<0euvre ref="vadb.phb"> 

<Titre> Vous avez dit baroque ? </Titre> 
<refAuteurs> 

<Ref valeur="PhBeaussant"/> 
</refAuteurs> 
</0euvre> 
<0euvre ref="marais.piecesl685"> 

<Titre> Pieces de viole en manuscrit </Titre> 
<refAuteurs> 

<Ref valeur="MMarais"/> 
</refAuteurs> 
</0euvre> 
<0euvre ref="l iatl c.bn"> 

<Titre> L'ingenieur aimait trop les chiffres </Titre> 
<refAuteurs> 

<Ref valeur="PBoileau"/> 
<Ref valeur="ThNarcejac"/> 
</refAuteurs> 
</0euvre> 
</LesOeuvres> 

<!-- ... suite du fichier sans interet pour l'exemple ... — > 

</BaseProduits> 

E n supposant que I 'etat du catalogue est fourni par les elements contenus dans I 'element 
<LesProduits>, on veut obtenir la liste des titres d'ceuvres correspondant a un livre au 
catalogue. 

Pour chaque <oeuvre>, on va done rechercher si celle-ci correspond a un livre ; si oui, on 
sort letitre de I'ceuvre. 

BaseProduits.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 



1: output method='text' encoding=' ISO-8 



<xsl : tempi ate match="Oeuvre"> 

<xsl :variable name="oeuvreCourante" select="."/> 

<xsl :for-each select="$l ivresAuCatalogue"> 

<xsl:if test="$oeuvreCourante/@ref = ./refOeuvre/Ref/@val 

- <xsl :value-of select="$oeuvreCourante/Titre"/> 
</xsl:if> 
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</xsl :for-each> 
si :template> 



<xsl template match="text( )"/> 
</xsl:stylesheet> 

Pour cefaire, on declare une variable globale livresAuCataiogue dont la valeur est un 
node-setcontenant tousles elements <Livre>del'element<LesProduits>.Cette variable 
n'est pas absolument indispensable, car il aurait ete possible d'ecrire I'expression 

XPath /BaseProduits/LesProduits/Livre directement COmme Valeur d'attribut select 

del'instructionxsi :for-each. Neanmoins, c'est plus clair, car plus prochede la semanti- 
que metier, de parler de livre au catalogue, quede/BaseProduits/LesProduits/Livre. 

La variable livresAuCataiogue est une variable globale, done le calcul de sa valeur se 
fait en prenant la racinede I'arbreXM L du document comme nceud contexte. Mais ici, 
I'expression XPath a calculer est un chemin absolu, ce qui rend inutile la connaissance 
du nceud contexte. II aurait toutefois ete possible et equivalent d'ecrire : 

<xsl :variable name="li vresAuCatalogue" select="BaseProduits/LesProduits/l_ivre"/> 

Cela aurait donne lememe resultat, etantdonne le nceud contexte utilise. 

Ceci etant, la suite du programme montre un exempled'emploi de variable (locale, cette 
fois-ci), dontil serait plus difficile dese passer. En effet, la variable oeuvreCourante per- 
met de garder au chaud le nceud courant, sachant qu'on va bientot le perdre, a cause de 
instruction xsi :for-each. Dans le modele d'instanciation du xsi :for-each, le nceud 
courant parcourt I'ensemble des livres au catalogue; on n'a done plus la possibility de 
connaitre I'ceuvre en cours, a moins de I 'avoir sauvegardee dans une variable. C'est ce 
qui est fait ici. 

Le critere de sortie d'un titre est que I'attribut ref de I'ceuvre courante soit egal a I'attri- 
but valeur de la Ref de la refoeuvre du livre au catalogue courant. 

Etvoici le resultat obtenu : 

Resultat 

I- Vingt mil le lieues sous les mers 

- Vous avez dit baroque ? 

- L'ingenieur aimait trop les chiffres 

II aurait ete possible de prendre le probleme a I'envers : e'est-a-dire d'ecrire une regie 
pour les <Livre>, et d'aller chercher I'ceuvre correspondante : 

BaseProduits.xsl 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl:stylesheet xmlns :xsl="http://www. w3.org/1999/XSL/Tra 

<xsl:output method='text' encodings' ISO-8859-1' /> 
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<xsl variable name="lesOeuvres" select="BaseProduits/LesOeuvres/Oeuvre"/> 

<xsl : tempi ate match="Li vre"> 

<xsl :variable name="reference" select=" ./refOeuvre/Ref/@valeur"/> 
- <xsl:value-of 

select="$lesOeuvres/Titre[ 
parent: :0euvre[ 

@ref = $reference 
] 
]"/> 
</xsl :template> 

<xsl: tempi ate match="text( )"/> 

</xsl: stylesheet) 

Remarque 

La section qui suit est a rapprocher de la remarque Nceud courant - Noeud contexte, page 89, qui anticipaitsur 
ce qui estexplique maintenant, en montrant qu'il y a lieu de distinguer nceud courant et nceud contexte, meme 
s'ilssontsouventconfondus. 

Le programme est un peu plus simple (pas de xsi :for-each, ni de xsi :if), par contre 
I'une des expressions X Path uti I i sees est nettement plus compliquee. 

La encore, deux variables sont utilisees, mais aucune n'est reellement necessaire. La 
vari abl e gl obal e pourrait etre faci I ement suppri mee ; la variable locale un peu moinsfaci- 
lement. Pourquoi ? Remarquons d'abord que des <oeuvre> qui sont des parents de 
<Titre>, il n'y en a pas qu'une; done le processeur XSLT est bien oblige defaire une 
boucle en interne pour rechercher eel I e qui correspond au critere sur les references. Cette 
boucle fait evol uer I e nceud contexte, qui va tour a tour designer chacune des ceuvres pos- 
sibles; et pour chacuned' el les, I e predicate @ref = $reference ] Sera eValUe, aveC Une 
valeur de @ref differente a chaque fois. 

Si I'on veut se passer de la variable locale reference, il faut done ecrire quelque chose du 
genre : 

parent: :0euvre[ @ref = ./refOeuvre/Ref /©valeur ] <!-- faux !! --> 

L'intention estcorrecte, maiscela ne marche pas, parcequele« . » dans ./refoeuvre/ 
Ref/@vaieur designe le nceud contexte (e'est-a-dire seif-nodeo, en notation longue). 
Or, precisement, comme on vient de le voir, le nceud contexte n'est pas stable dans I 'eva- 
luation du predicat. II faut reellement pouvoirrecupererici le nceud courant, et pour eel a, 
il n'y a que deux solutions : soit utiliser une variable (deja vu), soit utiliser la fonction 
predefine currento, qui, comme son nom I'indique, renvoiele nceud courant. 
On pourrait done se passer de variable en ecrivant la regie ainsi : 

<xsl :template match="Livre"> 
- <xsl :value-of 
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select='7BaseProduits/Les0euvres/0euvre/Titre[ 
parent: :0euvre[ 

@ref = current()/refOeuvre/Ref/@valeur 
] 
]"/> 
</xsl :templ ate> 

Personnel I ement, je prefere la version avec variable, parce qu'elle me semble plus claire 
et plus li sible. 

Temporary Source Tree 

Un Temporary SourceTree(ouTST) estl'arbreXML qui resulte del 'instantiation d'un 
modele de transformation. 

Lorsque ce modele de transformation est associe a une instruction <xsi :variat>ie>, le 
TST represente alors la valeur de cette variable, et c'est done la valeur renvoyee comme 
resultat lorsqu'on reference la variable. 

Remarque 

C'est ici qu'il y a une divergence assez profondeentreXSLT l.OetXSLT 1.1 

Plusprecisement, cequi est renvoye comme resultat, enXSLT 1.1 ou plus, c'est un node- 
set necontenantqu'un seul element, asavoir la racinedel'arbreainsi construit. 

Done, lorsqu'unetellevariableest instanciee (en XSLT 1.1 ou plus), il y aalorsau moins 
deux sources XML pour le programme XSLT : la premiere, qui existedetoutefacon tou- 
jours, est I'arbre XM L construit d'apres le document source a traiter ; la deuxieme est 
I'arbreXML qui resulte de I 'instanciation de la variable en question. 

Note 

Parcontre, en XSLT 1.0, la valeur d'une variable contenantunTST n'estpas de type node-set, mais d'un type 
special, ResultTree Fragment (RTF), propre a XSLT 1.0, etqui a disparu en XSLT 1.1 (voir ResultTree Fragment 
(XSLT 1.0), page 208). Le fait que ce ne soit pas un node-set interdit Implication d'expressions XPath au TST 
obtenuen referengantla variable. LeTST, en XSLT 1.0, n'est done pas une source XML a partentiere. 
En XSLT 1,1 ou plus, au contraire, I'arbre XML construit d'apres le document source a traiter, et le TST qui 
resulte de I'instanciation d'une variable contenantun modele de transformation sont traites a egalite de nature, 
notamment en ce qui concerne la possibility de leur appliquer des expressions XPath. TST est bien sur une 
denomination qui convient pour le futur de XSLT tel qu'on peut le comprendre au travers du Working Draft 
XSLT 1.1 ou du Working Draft XSLT 2.0, mais il faut savoir que ce n'est pas du tout une denomination officielle 
duW3C. 

Temporary Tree est une nouvelle denomination, initialement proposee par Michael Kay dans la deuxieme edition 
de son ouvrage de reference sur XS LT (parue apres la publication du Working Draft XSLT 1. 1), que j'ai legere- 
ment modifiee en Temporary Source Tree, pour mettre en evidence la notion de source, qui me semble ici tres 
importante. Le qualificatif de « temporaire » associe a un TST vient de ce qu'un TST n'a d'existence que durant 
I'execution, et que cette existence est limitee a celle de la variable a laquelle il est accroche. 
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Si Michael Kay a ete oblige d'inventer un nouveau terme, c'est parce que le Working Draft XSLT 1. 1 n'en propo- 
sait tout simplement pas. Pour les besoins des explications, M ichael Kay a du trouver un nom pour designer un 
arbre constituantla valeurd'une variable, etil a choisi Temporary Tree. P lus tard, Michael Kay estdevenu redac- 
teurde publication de la recommandation W3C pourXSLT 2.0, etle premier Working Draft (20 decembre 2001) 
a introduit la notion de Temporary Tree. 

Personnellement, j'aurais prefere parlerde Primary Source Tree, pour designer I'arbre source provenantdu docu- 
ment source a traiter, et de Secondary Source Trees, pour parler des arbres lies aux variables du programme. 
Neanmoins, comme I'ouvragede Michael Kayestune reference, et que le Working Group XSL du W3C semble 
lui emboiter le pas, il me semble preferable de ne pas tropm'ecarterde sa proposition, afin dene pas derouter 
les lecteurs avec une denomination exotique. 

II y a plusieurs vari antes deT ST, qui sol licitent plus ou moins lemoteurXSLT, maisces 
variantes ne dependent pas de la version (1.0 ou 1.1 et plus) de XSLT considered En 
effet, tantqu'on ne cherche pas a uti I i ser unTST, maisseulementaleconstruire, il n'y a 
aucune difference entre XSLT 1.0 etXSLT 1.1. C'estcequi etait rageanten XSLT 1.0 : 
on pouvait construire des TST tant qu'on voulait, mais il n'y avait pratiquement rien 
d'interessant pour les manipuler unefoisconstruits. Les variantes que nous allons main- 
tenant voi r sont des vari antes de constructi on, et non des vari antes a" uti I i sati on. 

TST obtenu litteralement 

La variante la plus simple, et qui sol I i cite le moins le moteur XSLT, est celle qui ne 
contient aucun element du domaine nominal "xsi : ; le TST est obtenu a partir d'un 
model ede transformation litteral, qui ne contient done aucun element calcule. 



Exemple: 



<xs 


1: vari able name="maison"> 






<RDC> 






<cuisine surface='12m2'> 






Evier inox. Mobilier enca 


stre. 




</cuisine> 






<WC> 






Lavabo. Cumulus 200L. 






</WC> 






<sejour surface='40m2'> 






Cheminee en pierre. Poutr 


es au plafond 




Carrelage terre cuite. Gr 


ande baie vit 




</sejour> 






<bureau surface='15m2'> 






Bibl iotheque encastree. 






</bureau> 






<jardin surface^ 150m2'> 






Palmier en zinc figurant 


le desert. 




</jardin> 






<garage/> 






</RDC> 




</x 


sl:variable> 
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Cette variable est done lieeaunTST construit a partir d'un fragment de document XM L 
parfaitement correct, e'est-a-direbien forme : un seul element racine, et structure d'arbre 
respectee. 

LeTST en question esttoutsimplementl'arbreXML resultant (voir figure 5-2). 




text 




_ text 


Evierinox. 




Lavabo. 


Mobilier 




Cumulus 


encastre. 




200L. 



Cheminee en 

pierre. 

Poutres au 

plafond. 

Carrelage terre 

cuite. 



Figure 5-2 

Temporary Source Tree attached la variable « maison ». 



almieren zinc 
figurant le 

desert 



Les nceuds de type fexfnecontenantquedesespaces blancs nesontpas montres, afin de nepassurchargerla 
figure ; pour voir ce que cela donne quand on en tient compte, voir figure 5-3. 



M ais la structure d'arbre que doit verifier un TST pour etre correct est moins contrai- 
gnante que celleimposee par I e standard XML pour un document XML. En effet, XML 
impose qu'un document commence par un seul element, appele element racine du 
document (la racine del'arbreX ML n'adonc qu'un seul enfant, qui est I 'element racine 
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du document) ; un TST est dispense de cette contrainte : non seulement il peut y avoir 
plusieurs elements au premier niveau del'arbre, maisdeplus, il peuty avoir du texte non 
balise. Laformelaplusgeneraled'unTST obtenu litteralement est done tout si mplement 
celle qui resulte de I'instanciation d'un model ede transformation litteral (voir Module de 
transformation litteral, page 81), commececi : 

<xsl :variable name="instrument"> 

viole de gambe 

<Interprete> Rika Murata </Interprete> 

<Interprete> Martin Bauer </Interprete> 

<Interprete> Sophie Watillon </Interprete> 
</xsl: variable) 

lei, la racineduTST resultatde devaluation de la variable instrument n'a pas un enfant 
unique, commecedevraitetrelecas pour un document XM L ; il y a en fait sept enf ants 
accrochesala racineduTST («\n » designeunefin deligne, et«\t» une tabulation) : 

• un premier enfant de type text :\n\tvioledegambe\n\t; 

• un deuxieme enfant de type element : <Interprete> Rika Murata </Interprete> ; 

• un troisieme enfant de type text : \n\t ; 

• un quatrieme enfant de type element : <Interprete> Martin Bauer </Interprete> ; 

• un ci nquieme enfant de type text : \n\t ; 

• un Sixieme enfant de type el ement : <Interprete> Sophie Watillon </Interprete> ; 

• un septieme enfant de type text : \n\t. 

La figure 5-3 donne une representation graphique de cette structure d'arbre ; on pourra 
comparer avec la figure 6-2 qui montre une structure d'arbre XML correct. 



\n\tviole de [ 
gambe\n\t ^~ 




Figure 5-3 

UnTST sans element racine unique. 
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Lorsquelemodelede transformation associe a uneinstructionxsi : variable contientdes 
instructions XSLT (c'est-a-dire des elements XML prefixes par "xsi :"), le TST n'est 
plusobtenu litteralement, il est calcule. Exemple: 



/ariable name="mc 



<insert> 




<Ensemble> 




<NomXxsl :va 


ue-of select="NomEnsemble"/X/Nom> 


<Di recti on>< 


sl:value-of select="Chef'7X/Di rection> 


</Ensemble> 




<Concert> 




<DateXxsl:v 


1 ue-of select="Date'7X/Date> 


<VilleXxsl: 


alue-of select="Ville"/X/Ville> 


<LieuXxsl:v 


1 ue-of select="Salle'7X/Lieu> 


<TitreXxsl: 


alue-of select="TitreConcert'7X/Titre> 


</Concert> 




</insert> 




</xsl:variable> 





Le TST obtenu en evaluant la variable movement est un arbre XML d'element racine 

<insert>, dont la descendance est COnStitUee d'elementS fixes (Ensemble, Norn, Date, 

etc.) : lesqueletteestimmuable, mais lescontenusdes nceuds text qui lui sont rattaches 
sontcalcules, done sont variables en foncti on du document XM L qui subit la transforma- 
tion XSLT. 



Note 

II y aurait une autre facon d'envisager un TST calcule, ou le nom des elements seraient eux-memes calcules, au 
lieu d'etre fixes comme ici. C'est possible a realiser, il faut pour cela utiliser I'instruction xshelement Nous 
verrons cela dans le chapitre sur les instructions de creation (voir Instruction xshelement, page 272). 

TST-texte 

II y a un cas particulier tres frequent de TST : c'est celui ou le TST necontient quedu 
texte. On peut dire que c'est une forme degeneree, en cesensqu'il n'y a plus vraimentde 
structure d'arbre, mais un simple nceud texte rattache a la racine. LeTST estalors a peu 
pres equivalent a une String. Exemple : 

<xsl variable name="instrument">saqueboute</xsl :variable> 

On peut comparer cette declaration de variable a eel I e-ci : 

| <xsl :variable name="instrument" select=" 'saqueboute' "/> 

Concretement, cesdeux declarations sont interchangeables, du moinssi lebutestd'avoir 
une variable qui contienneunechainedecaracteres. En effetnous verrons (voir Opera- 
tions sur unTST (XSLT 1.1 ou plus), page 198) qu'unTST peuttoujoursetreconverti en 
String ; dans lecasci-dessus, il est clair que la conversion esttriviale. 
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On remarquera au passage que la declaration avec un model ede transformation est plus 
simple que eel I eavec I * attri but select, danslecasou la valeur a attribuer est une String 
litterale. En effet, pour indiquer une String litterale en tant que valeur d' attri but, il faut 
deux niveaux deguillemets ou apostrophes : 

<xsl variable name="instrument" select="saqueboute"/> <!— faux ! --> 

Dans la declaration ci-dessus, cen'est pas la String litterale "saqueboute" qui estfour- 
nie comme valeur d'attribut, e'est une expression Xpath qui est la forme courte de 
child: : saqueboute. L'expression va done selectionner un node-set constitue detous les 
elements filsdu noeudcontextequi sontdes<saqueboute> ; il y a done toutes les chances 
que le resultat soit un node-set vide. Ensuite, si I'on reference la variable en question 
enecrivant$instrument laou une String estattendue, le node-set (vide) seraconverti en 
String, ce qui donnera une String vide, et done un resultat inattendu. Ce genre d'erreur 
n'est pas forcement evident a detecter. 

Un TST reduit a un nceud texte n'est pas necessairement obtenu litteralement; il est 
meme frequent qu'un TST-texte soit calcule. Exemple : 

<xsl variable name="result"> 

<xsl:value-of select='concat( $repl acement, .)'/> 
</xsl:variable> 

Dans cet exemple, la variable result est associee a un modele de transformation, dont 
I'instanciation donnedonc unTST. CeTST contient une String dont la valeur est fournie 
par une instruction xsi:vaiue-of (dont I'attribut select contient une expression sans 
importance pour les explications) au lieu d'etre litterale comme dans I 'exemple prece- 
dent. 

On peut all er plus loin dans la complexity du modele de transformation, sans que cela 
change la structure de TST-texte que I'on obtient lors de I'instanciation, meme si 
cela semble moins evident a la lecture : 

I <xsl :variable name="result"> 

<xsl variable name="begin" select="$fragments[position( ) = 1]'7> 

<xsl :choose> 

<xsl :when test="starts-with( SunTexte, SgivenChar )"> 
<xsl:va1ue-of select="$replacement"/> 
<xsl:value-of select="$begin"/> 
</xsl :when> 
<xsl :otherwise> 

<xsl :value-of select="$begin"/> 
</xsl :otherwise> 
</xsl :choose> 

<xsl :for-each select="$fragments[position( ) > 1]"> 
<xsl :value-of select='concat( $ replacement, .)'/> 
</xsl:for-each> 
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Cettefois, le model ede transformation a instancier est nettement plus complique ; mais 
la variable resin t est toujours associee a un TST compose d'une raci ne a laquelle est rat- 
tache un seul noeud text, contenant une chaine de caracteres qui est ici constitute petit a 
petit par tout un algorithme (sans interet pour les explications qui suivent). 

II faut remarquer que pour faciliter I'ecriture de cet algorithme, une variable auxiliaire 
begi n a ete utilisee : et de fait, une instruction xsi : vari abi e pouvant apparaitre dans tout 
modelede transformation, rien n'interdit qu'elle apparaisse dans un modelede transfor- 
mation lui-meme associe a une declaration de variable. Dans cet algorithme, seules les 
instructions xsi :vaiue-of vont en fin de compte contribuer a constituer la chaine de 
caracteres finale, que I 'on retrouveracommevaleurdu noeud textedu TST instancie. 
En effet, lors de I'instanciation de ce modele de transformation, seules les instructions 
xsi :vaiue-of seront remplacees par quelque chose; toutes les autres (xsi variable, 

xsi :choose, xsi :when, xsi otherwise, xsi :for-each) SOnt remplacees par rien (C'est-a- 

dire sont supprimes : rien est la valeur de remplacement). 
Operations sur unTST (XSLT 1.1 ou plus) 

Attention 

Ce qui est dit dans cette section ne s'applique pas a XSLT 1.0, mais aux versions ulterieures. 

UnTST est instancie lorsdu calcul dela valeur d'initialisati on d'une variable possedant 
un modele de transformation ; quand on reference cette variable, on recoit en retour un 
node-set ne contenant qu'un seul nceud, la racine du TST. 

Ce node-set est alors utilisable partout ou un node-set est attendu, et on peut appliquer a 
ce node-set toutes I esfonctions XSLT ou expressions X Path standard. 

En particulier, il est assez frequent qu'un TST soitconverti en String, caril est assez fre- 
quent qu'un TST soit utilise dans sa forme degeneree, reduiteaun simple texte. Dansce 
cas, si on fournit un TST alors qu'une String est attendue, il y a conversion implicite du 
TST en String. Cette conversion peut intervenir aussi bien dans le cas oil le TST est un 
arbrea partentiere(c'est-a-direun arbrequi n'estpas reduita un nceud texte: la conver- 
sion d'un node-set en String s'applique alors), mais c'est moins interessant, done plus 
rarement utilise. 

Dans toute cette section, concernant I 'utilisation d'un TST en XSLT1.1 ou plus, nous 
fournirons des exemples avec la convention utilisee par Saxon 6.5, le processeur 
XSLT de Michael Kay. Avec Saxon 6.5, la manipulation deTST au sein d'expressions 
XPath peut se faire sans conversion explicite en node-set, a condition de preciser une 
valeur superieure a 'l.o' (par exemple 'l.i') pour I'attribut version de I'element 
<xsi :styiesneet>, commececi : 

Utilisation transparente d'un TST avec Saxon 6.5 

|<xsl :stylesheet 
xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 
version="l.l"> 
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Exemples d'utilisation d'unTST (XSLT 1.1 ou plus) 

Utilisation d'unTST obtenu litteralement (XSLT 1.1 ou plus) 
UnTST obtenu litteralement sert en general a definir desconstantes symbol iques struc- 
turees. Ce sont des constantes parce que rien n'est calcule, et elles sont symboliques 
parce que le nom des balises employees va pouvoir servir a les references grace a une 
expression X Path adequate. 

Imaginonsparexemplequel'on veui lie obtenir une seriede pages HTM L ayanttoutesle 
meme en-tete ; on pourrait bien sfir declarer plusieurs variables enteteGauche, entete- 
centre, et enteteDroi te, et les referencer la ou on a besoin. M ais les avantages d'utiliser 
des variables structures (comme celles de type struct en C) sont connus ; ici on peut 
structurer cestrois informations en les regroupantdefacon hierarchique: 

Note 

Obtenir une serie de pages HTML implique bien surque I'on sache creer plusieurs fichiers de sortie, dontle nom 
est fourni par une expression adequate (de fagon a obtenir par exemple pagel.html, page2.html, etc.). La 
encore, il faudra patienter jusqu'a la version 2,0 du standard XSLT ; en attendant, on continuera a utiliser 
unefonction d'extension disponible (malheureusement sous des formes tres diverses) avec les principaux 
processeurs XSLT du marche. Un exemple est disponible a la section Pattern n' 20 -Generation de documents 
multiples, page 563. 

si variable name="ent6te"> 
<hautDePage> 
<gauche> 



</centre> 
<droite> 

baroque 
</droite> 
</hautDePage> 
</xsl:variable> 

Voici le programme XSLT : 

Concerts .xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl: stylesheet 

xmlns:xsl -"http://www.w3.org/1999/XSL/Trar 

version="l.l"> 

<xsl:output method='html ' encoding=' ISO-E 
<xsl variable name="entete"> 
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<gauche> 

musique 
</gauche> 
<centre> 

Anacreon 
</centre> 
<droite> 

baroque 

</droite> 

</hautDePage> 

</xsl:variable> 

<xsl : tempi ate match="/"> 
<html> 
<head> 

<title><xsl:value-of select="/Concert/Entete'7></title> 
</head> 

<body bgcolor="white" text="black"> 

<TABLE valign="top" wi dth="100%" hei ght="2%" B0RDER="0" > 
<TR> 

<TD align="left"> 
<xsl:value-of 

select="$entete/hautDePage/gauche"/> 
</TD> 
<TD align="center"> 

select="$entete/hautDePage/centre"/> 
</TD> 

<TD align="right"> 

<xsl:value-of 

select="$entete/hautDePage/droite"/> 
</TD> 

</TR> 
</TABLE> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :template> 

<xsl : tempi ate match="Entete"> 

<p> <xsl :val ue-of select="."/> presentent </p> 
</xsl :templ ate> 



<xsl :template match="Date"> 

<H1 al ign="center"> Concert du <xsl :val ue-of select=" 
</xsl: tempi ate> 

<xsl :template match="Lieu"> 

<H4 align="center"> <xsl :val ue-of select="."/> </H4> 
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<xsl :template match="Ensemble"> 

<H2 align="center"> Ensemble <xsl :val ue-of select=" . "/></H2> 
</xsl :template> 

<xsl :template match="Compositeurs"> 

<H3 align="center"> Oeuvres de <br/> <xsl :val ue-of select=" ."/> </H3> 
</xsl :template> 

<xs1 : tempi ate match="text( )"/> 
</xsl:stylesheet> 

Onappli que cettefeui I lede style aufichiersuivant (en faisant abstraction duproblemede 
la generation de pages HTM L multiples) : 

Concerts .xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 



<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Compositeur>M. Marais</Compositeur> 

<Compositeur>D. Castello</Compositeur> 

<Compositeur>F. Rognoni</Compositeur> 
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</Compositeurs> 
</Concert> 



On obtient le resultat suivant (voir aussi figure 5-4) : 

Concerts.html 

| <html xmlns:xalan="http://xml .apache.org/xalan"> 
<head> 

<META http-equiv="Content-Type" content="text/html ; charset=IS0-8£ 
<title> Les Concerts d’Anacréon </title> 
</head> 

<body text="black" bgcolor="white"> 

<TABLE BORDER="0" height="2%" width="100%" val ign="top"> 
<TR> 
<TD align="left"> 

musique 

</TDXTD align="center"> 
Anacréon 

</TDXTD align="right"> 
baroque 

</TD> 
</TR> 
</TABLE> 

<H1 align="center"> Concert du Jeudi 17 Janvier 2002, 20H30</H1> 
</body> 
</html> 



Figure 5-4 

Transformation par 
Concerts.xsl. 



= Netscape: Les Concerts d'Anacreon = 



3 & ^ l^i <- ISI 

Back Forward Reload Homo Search Netscape Images 






Concert du Jeudi 17 Janvier 
2002, 20H30 



i '■■- ,.^Ga -,.&\ 
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Utilisation d'unTST calcule (XSLT 1.1 ou plus) 

On suppose ici que nous devons maintenir une base de donnees qui contient des en- 
sembles, etdesdatesetlieux de concerts, en vued'editer un catalogue de festivals d'ete, 
parexemple. 

Cette base de donnees est mise a jour de differentes manieres ; I 'une d'entre elles consiste 
a exploiter trois fichiers qui arrivent periodiquement d'une source exterieure : un fichier 
rawinsert.xmi, qui contient des insertions a effectuer; un ficher rawUpdate.xmi, qui 
contient des misesajour, et rawDeiete.xmi, qui contient des suppressions. 
Lefichier rawinsert.xmi ressemble a ceci : 

rawinsert.xmi 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<insertions> 
<Concert> 

<NomEnsemble>A deux violes esgales</NomEnsemble> 

<Chef>-</Chef> 

<Date>Jeudi 17 Janvier 2002, 20H30</Date> 

<Ville>Angers</Ville> 

<Salle>Chapelle des Ursules</Sal le> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 

</TitreConcert> 
</Concert> 
<Concert> 

<NomEnsemble>La Cetra d'0rfeo</NomEnsemble> 

<Chef>Michel Keustermans</Chef> 

<Date>Mercredi 20 Mars 2002, 20H30</Date> 

<Ville>Bordeaux</Ville> 

<Salle>Theatre</Salle> 

<TitreConcert> 
Habendmusi ken 

</TitreConcert> 
</Concert> 
<Concert> 

<NomEnsemble>Suonare e cantare</NomEnsemble> 

<Chef>Jean Gail lard</Chef> 

<Date>Vendredi 26 octobre 2001, 20H30</Date> 

<Ville>Nantes</Ville> 

<Salle>Musee des Beaux-Arts</Sal le> 

<TitreConcert> 

Madrigal i e altre musiche concertate 

</TitreConcert> 
</Concert> 
</insertions> 

On veutfaire un fichier synthesedetous les mouvements a realiser, suivant un format qui 
n'est pas forcement celui du fichier montre ci-dessus. 
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Parexempleon voudraitun fichier d'insertionssepresentantcommececi : 
insert.xmlr 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Mouvements> 
<insert> 
<Ensemble> 

<Nom>A deux violes esgales</Nom> 
<Di recti on>-</Di recti on> 
</Ensemble> 
<Concert> 

<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Ville>Angers</Ville> 
<Lieu>Chapelle des Ursules</Lieu> 
<Titre> 

Folies d'Espagne et diminutions d'ltalie 



<Ensemble> 

<Nom>La Cetra d'0rfeo</Nom> 
<Di recti on>Michel Keustermans</Di recti on> 
</Ensemble> 
<Concert> 

<Date>Mercredi 20 Mars 2002, 20H30</Date> 

<Ville>Bordeaux</Ville> 

<Lieu>Theatre</Lieu> 

<Titre> 

Habendmusiken 
</Titre> 
</Concert> 
</insert> 
<insert> 
<Ensemble> 

<Nom>Suonare e cantare</Nom> 
<Direction>Jean Gail 1 ard</Di rection> 
</Ensemble> 
<Concert> 

<Date>Vendredi 26 octobre 2001, 20H30</Date> 

<Ville>Nantes</Ville> 

<Lieu>Musee des Beaux-Arts</Lieu> 

<Titre> 

Madrigal i e altre musiche concertate 
</Titre> 
</Concert> 
</insert> 
*louvements> 

La transformation de structure peut se faire tres simplement : il suffit de « cabler » la 
nouvelle structure dans un modele de transformation. L'instanciation de ce modele de 
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transformation pour chaque <coi 
donnera le resultat souhaite : 



preparelnsert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 



:rt> rencontre dans le fichier donne rawinsert.xmi 



<xsl:output method='xml' encoding=' ISO-E 

<xsl : tempi ate match="/"> 

<Mouvements> 

<xsl :apply-templates/> 

</Mouvements> 
</xsl :templ ate> 

<xsl :template match="Concert"> 

<xsl :variable name="mouvement"> 
<insert> 

<Ensemble> 

<NomXxsl:va 
<DirectionX 
</Ensemble> 
<Concert> 

<DateXxsl :v 
<VilleXxsl: 



;elect="Date"/X/Date> 
select="Ville"/X/Ville> 

;elect="Salle"/X/Lieu> 
select="TitreConcert"/X/Titre 



</xsl:variable> 
<xsl :copy-of select="$rr 
</xsl :template> 



<xsl :template n 
csl:stylesheet> 



itch="text()"/> 



Soyons honnetes, si on lance la feui I lede style ci-dessussur I e fichier rawinsert.xmi, le 
resultat ne sera pas aussi beau que celui montre ci-dessus (fichier insert. xmi) ; en fait, 
voici qu'on aura : 

insert.xml 

<?xml version="1.0" encodings" IS0-8859-l"?XMouvementsXinsertXEnsembleXNom> 
A deux violes esgales</NomXDirection>-</DirectionX/EnsembleXConcertXDate> 
Jeudi 17 Janvier 2002, 20H30</DateXVil le>Angers</VilleXLieu>Chapel le des Ursules 
</LieuXTitre> 

Folies d'Espagne et diminutions d'ltalie 
</TitreX/ConcertX/insertXinsertXEnsembleXNom>La Cetra d'0rfeo</Nom> 
<Direction>Michel Keustermans</DirectionX/EnsembleXConcertXDate>Mercredi 20 mars 
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2002, 20H30</DateXVille>Bordeaux</VilleXLieu>Theatre</LieuXTitre> 
Habendmusiken 
</Titre></Concert></insert><insert><EnsembleXNom>Suonare e cantare</Nom> 
<Direction>Jean Gaillard</Direction></Ensemble><Concert><Date>Vendredi 26 octobre 
2001, 20H30</DateXVille>Nantes</VilleXLieu>Musee des Beaux-Arts</LieuXTitre> 
Madrigal i e altre musiche concertate 
</TitreX/ConcertX/insertX/Mouvements> 

Pour obtenir un resultat lisible, il faut ajouter I'attribut indent='yes' dans instruction 
xsi output, commececi : 

<xsl:output method="xmr encodings' ISO-8859-1" indent='yes' /> 

Ceci dit, I'exemple que nous venons de montrer n'est pas specifique a la version 1.1 ou 
plusdeXSLT ; en effet leTST est utilise commeciblede I 'instruction xsi :copy-of, ce 
qui n'est pas interdit par XSLT 1.0. Nous verronsqu'une operation sur unTST est pos- 
sible en XSLT 1.0, a condition qu'elle soit applicable a une String (voir Operations sur 
un RTF (XSLT 1.0), page 209) ; or uneString peutetrecopieepar un xsi :copy-of. 

Mais il est evident qu'un programme tel que celui montre ci-dessus, est susceptible 
d'evoluer, etqu'il est probable qu'un jour ou I'autre, on aurabesoin d'ecrire: 

<xsl :copy-of select="$mouvement/insert/Enseirible"/> 

en plusde: 

<xsl :copy-of select="$mouvement"/> 

Cettefois, I e programme sera incompatible avec I a version 1.0 de XSLT, etil faudraalors 
declarer la valeur 1.1 pour I'attribut version de la declaration <xsi :styiesheet>, si tou- 
tefois on utilise le processeur Saxon 6.5. 

Utilisation d'un TST-texte pour le calcul de la valeur par defaut d'un attribut 

Remarque 

Ce qui estditici est compatible avec XSLT 1.0, parce que leTST utilise estseulement converti en String, ce qui 
est permis en XSLT 1.0, comme on le verra plus loin ( voir Operations sur un RTF (XSLT 1.0), page 209). 

En XML, il est possible, dans certaines conditions, qu'un element ait un attribut faculta- 
tif ; s'il estomis, I 'application detraitementdu fichier XML estcenseepouvoir affecter 
une valeur par defaut a cet attribut, si toutefoisc'estnecessaire. 

Pour faire cela en XSLT, rien de plus simple: il suffit de declarer une variable avec 
modelede transformation, contenantun calcul de valeur par defaut. Exemple: 

produits.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<LesProduits> 

I<Li vre ref="vernesl" NoISBN="193335" gamme="roman" media="papier"> 
<ref0euvre> 
<Ref valeur="200001slm"/> 
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</refOeuvre> 

<Prix valeur="40.5" monnaie="FF"/> 
<Prix valeur="5" monnaie="£"/> 
</Livre> 

<Livre ref="boileaunarcejacl" NoISBN="533791" gamme=" 
<refOeuvre> 

<Ref valeur="liatlc.bn'7> 
</refOeuvre> 
<Prix valeur="30"/> 



lei, on peut i magi ner quel 'attri but monnaie de I 'element <Prix> soitfacultatif ; s'il n'est 
pas fourni, sa valeur sera « FF » par defaut. Void comment proceder : 

produits.xsl 



<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xml ns:xsl="http: //www. w3.org/1999/XSL/Transforir 



<xsl:output method='text' encoding=' ISO-8859-1' / 

<xsl : tempi ate match="Livre"> 

<xsl :choose> 

<xsl :when test="Prix/@monnaie"> 

<xsl :val ue-of select="Prix/@monnai 
</xsl :when> 

<xsl :otherwise>FF</xsl :otherwise> 
</xsl :choose> 
</xsl:variable> 



ref : <xsl :val 


ue-of sel 


ect="@ref"/> 








prix: <xsl :va 


1 ue-of 










select^ 


'Prix/@va 


leur"/> <xsl:va 


ue-of s 


elect= 


"$monna 


1 :templ ate> 













<xsl : tempi ate match="text( )"/> 
<sl: stylesheet) 

A pres execution, on obtient ceci : 
Resultat 

ref: vernesl 
prix: 40.5FF 

ref: boileaunarcejacl 
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Dans le modele de transformation de la variable monnaie , on notera I 'alternative pour 
instancier leTST : dansunebrancheon instance une chainedecaracteresprovenantde 
I 'evaluation d'une expression, dans I'autre on instancie une valeur litterale (FF). Letest 
effectue, qui permet de savoir si la chaine de caracteres Prix/@monnaie est vide ou non, 
selectionne une des deux branches. 

Result Tree Fragment (XSLT 1.0) 

Attention 

Ce qui est dit dans cette section s'applique a XSLT 1.0 ; on peut ignorerdonc toutce qui suit si on travaille avec 
un processeurXSLTconforme aux propositions du XSLT Working Draft 1.1 ou 2.0. 

En XSLT 1.0, un modele de transformation associe a un element <xsi :variabie> ou 
<xsi:param> est un arbre XML, qu'on peut continuer a appeler un TST (Temporary 
SourceTree) ; jusquela, aucune difference avec ce qu'on a vu. La ou tout bascule, c'est 
que le TST n'est pas de type node-set, maisd'un type special, appele RTF (Result Tree 
Fragment). 

Un Result Tree Fragment (ou RTF) est un cinquieme type de donnee XSLT, qui vient 
done s'ajouter aux quatre types XPath que sont les types String, Number, Boolean et 
N ode-set. 

En XSLT 1.0, la notion de node-set est exclusivementreservee aux ensembles constitues 
de nceuds issus de I 'arbre XM L du document source XML a traiter. Les arbres XML 
provenant de I'instanciation d'un modele de transformation associe a une variable ne 
peuvent pas donner lieu a un node-set : ils sont comme pestiferes, et affubles d'un nom 
bizarre qui acheveleur miseal'ecart. 

Note 

RTF veutdire Result Tree Fragment Or un RTF n'est pas un fragment d'arbre, mais un arbre, etiln'a pasforce- 
ment a voir avec le document resultat de la transformation XSLT : c'est en cela que le nom RTF est un peu 
bizarre. 

Cette mise a I'ecart n'est pas seulement genante dans le principe, el I e I ' est aussi concre- 
tementcarelleempechepratiquementtoutemanipulationXPathsurun RTF. Or un arbre 
sans XPath, c'est comme un parachute sans suspentes: pas tres commode a utiliser. 
Impossible par exemple de recuperer la surface du bureau, quand on a ecrit : 



<xsl :variable n 


ame="maison"> 


<RDC> 




<cuisin 


e surface='12m2'> 


Evi 


er inox. Mobilier 


<WC> 




Lav 


abo. Cumulus 200L 


</WC> 
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<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande baie vitree. 
</sejour> 
<bureau surface=' 15m2'> 

Bibliotheque encastree. 
</bureau> 
<jardin surface=' 150m2'> 

Palmier en zinc figurant le desert. 
</jardin> 
<garage/> 
</RDC> 
</xsl:variable> 

alors qu'une expression du genre : 

<xsl :value-of select="$raaison/RDC/bureau/@surface"/> 

semble pourtant parfaitement plausible et utile. E I le n'a que le tort d'etre interdite. 

On voit done que la fonction d'extension, disponible avec la plupart des processeurs 
XSLT (Xalan, Saxon, Xt...), permettant la conversion entreun RTF etun node-set ne fait 
que reparer une injustice, et n'a pas grand travail a effectuer vu I 'extreme ressemblance 
entre un RTF -set et un node-set. 

Cela etant, la future version XSLT2.0 de XSLT va operer sa revolution, et abolir ces 
arbres de seconde classe que sont les RTF ; un modele de transformation lie a une va- 
riable sera considers comme un nouveau et veritable document source, et une reference a 
cette variable renverra un node-set, auquel on pourra appliquer toutes les expressions 
XPath que I 'on voudra. 

Operations sur un RTF (XSLT 1.0) 

Que peut-on faire d'un RTF ? Le langage XSLT (1.0) n'autorise que deux operations 
possibles sur un RTF : 

• On peutleconvertirenString, par application de la fonction standard stringo, impli- 
citementou explicitement; la conversion est implicite si le RTF figure comme valeur 
de I 'attri but select del 'instruction xsi :vaiue-of. 

Danscecas, la valeur du RTF convertieen String est egale a la concatenation detous 
ses nceuds de type text, pris dans I'ordre de lecture du modele de transformation 
duquel le RTF provient. 

• On peut aussi le copier tel quel dans le document resultat de la transformation, en le 
donnant comme valeur del'attri but select del 'instruction xsi :copy-of. 

En resume, une operation est possible sur un RTF a condition qu'elle soit possible sur 
une String. 

A part ces deux operations prevues dans I e standard, les principaux processeurs XSLT du 
marche offrent une fonction d'extension permettant de convertir un RTF en node-set, ce 
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qui ouvreconsiderablementle champ des possibility d'utilisation, dans la mesureou une 
variable associee a un RTF calcule peut alors etre considered comme une structure de 
donnees exploitable a I 'aide d'expressions XPath adequates, comme Test un TST en 
XSLT 1.1. Tantqu'on n'a pas cette fonction deconversion, on peut certes creer la struc- 
ture de donnees, maison ne peut guere I 'exploiter, cequi est tout dememeassez rageant, 
il fautbien lereconnaltre. 

Pour montrer comment utiliser une telle fonction de conversion, nous allons reprendre 
I'exemplevu a la section Utilisation d'un TST obtenu litte'ralement (XSLT 1.1 ou plus), 
page 199. 
L e programme est legerement transforme, comme ceci : 

Concerts.xsl 

<?xml version="1.0" encoding="UCS-2"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

xmlns:xalan="http://xml .apache.org/xalan" 

version="1.0"> 

<xsl:output method='htmr encodings ISO-8859-1' /> 

<xsl variable name="entete"> 
<hautDePage> 
<gauche> 

musique 
</gauche> 
<centre> 

Anacreon 
</centre> 
<droite> 

baroque 

</droite> 

</hautDePage> 

</xsl:variable> 

<xsl : tempi ate match="/"> 
<html> 
<head> 

<title><xsl:value-of select="/Concert/Ent8te"/X/title> 
</head> 

<body bgcolor="white" text="black"> 

<TABLE valign="top" width="100r hei ght="2%" BORDER="0" > 
<TR> 

<TD align="left"> 
<xsl:value-of 

select="xalan:nodeset($entete)/hautDePage/gauche"/> 
</TD> 

<TD align="center"> 
<xsl:value-of 
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select="xalan:nodeset($entete)/hautDePage/centre"/> 
</TD> 

<TD align="right"> 

<xsl:value-of 

select="xalan:nodeset($entete)/hautDePage/droite"/> 
</TD> 

</TR> 
</TABLE> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :template> 

<xsl :template match="Entete"> 

<p> <xsl:value-of select="."/> presenters </p> 
</xsl :template> 

<xsl : tempi ate match="Date"> 

<H1 align="center"> Concert du <xsl : value-of select="."/> </Hl> 
</xsl :template> 

<xsl : tempi ate match="Lieu"> 

<H4 align="center"> <xsl : val ue-of select=".'7> </H4> 
</xsl :template> 

<xsl :template match="Ensemble"> 

<H2 align="center"> Ensemble <xsl :val ue-of select=" . "/></H2> 
</xsl :template> 

<xsl :template match="Compositeurs"> 

<H3 align="center"> Oeuvres de <br/> <xsl :val ue-of select="."/> </H3> 
</xsl :template> 

<xsl: tempi ate match="text( )"/> 
</xsl:stylesheet> 

On remarquera la facon dont on procede pour obtenir I'autorisation d'utiliser unefonc- 
tiond'extension : il faut declarer un nouveaudomaine nominal, en plus decelui d'XSLT, 
abrege en "xsi :". En I'occurrence, avec le processeur Xalan, le domaine nominal est 

http://xml .apache.org/xalan ; on Choisit une abreviation (ici "xalan:"), eta I'appel, 

le nom de la fonction doit etre qualifie par I 'abreviation choisie : 

<xsl : val ue-of select="xalan:nodeset($entete)/hautDePage/droite"/> 



Note 

Avec Saxon, on aurait a declarer le domaine nominal http ://icl.com/saxon. 
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Regies de visibilite 

Les regies de visibilites indiquent si tel I e reference a une variable est autori see, en fonc- 
tion de I'endroit ou est declaree la variable, et de celui ou el I e est referenced. 

Regies de visibilite pour les variables globales 

Pour les variables globales, les regies sont tres simples : une variable globale peut etre 
referencee de n'importe quel endroit du programme XSLT, a la seule condition que la 
declaration ne soit pas circulaire (c'est-a-dire que la declaration ne contienne pas, direc- 
tement ou indirectement, de reference a elle-meme) : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl variable name="valeur"> 

<xsl:value-of select="$valeur"/> <J— interdit ! --> 
</xsl:variable> 

<xsl :template match="TitreConcert" > 

</xsl :template> 

<xsl :template match="Concert"> 

</xsl :template> 

</xsl:stylesheet> 

instruction ci-dessus xsi :vaiue-of avec son attribut seiect="$vaieur" est interdite 1 
(elle introduit une circularite directe) ; de meme, le programme ci-dessous pourrait etre 
incorrect: 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="l .0"> 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl:variable name="truc"> 



<xsl :template match="TitreConcert" > 
</xsl :template> 

<xsl :template match="Concert"> 
5 de la meme fa^n, il ne faut pas oublier que c' est interdit de fumer en jouant du hautbois. 
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<xsl :value-of select=" 
</xsl :templ ate> 



</xsl: stylesheet) 



Remarquez ici le modele de transformation de la variable true : il contient une instruc- 
tion xsi :appiy-tempiates. Or, une variable global e est evaluee avec la racine de I'arbre 
XM L du document comme nceud contexte: I 'instruction xsi :appiy-tempiates va done 
relancer le moteur XSLT sur I'element fils de cette racine, puis eventuellement, sur 
d'autres elements, si d'autres instructions xsi :appiy-tempiates sont rencontrees. Rien 
ne dit que dans ce processus, le moteur selectionnera la regie <xsi : tempi ate match= 
"Concerts. Si elle n'est pas selectionnee, le programme ci dessus est correct, du moins 
quant a I 'evaluation de la variable true ; si el le est selectionnee, une circularite indirecte 
apparait, et le programme est alors incorrect. 

Eviter les circularites est la seule precaution a prendre dans la declaration et la manipula- 
tion de variables globales ; en particulier, il n'est pas interdit de referencer une variable 
dont la declaration n'intervientqu'un peu plus loin dans I'ordre de lecture du document: 
c'estcequ'on appellecommunement une reference avant dans lesautreslangages. Les 
references avant sont interdites en C, autoriseesenjava, etaussi en XSLT, maisunique- 
ment pour les variables globales. 

U ne autre source de circularite potentielle serait la presence d'une reference de variable 
dans un motif. C'est pour cette raison que e'est interdit, ainsi que nous I'avons deja 
signale (voir D ans un motif, page 185). 

Si cela etait possible, on pourrait ecrire quelque chose comme ceci : 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings ISO-8859-1 ' /> 



<xsl :apply-templates /> 
</xsl:variable> 

<xsl : tempi ate match="$amorce/ child: :Interprete/ child: :Nom" > 

</xsl :template> 

<xsl : tempi ate match="..." > 

</xsl : tempi ate> 

</xsl: stylesheet) 

II serait alors impossible d'evaluer le motif sans connaitre la variable ; mais I 'evaluation 
de la variable entraine une recherche de concordance de motif, qui ne peut s'effectuer 
tant que la variable n'est pas connue... 
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Regies de visibilite pour les variables locales 

Pour les variables locales, les regies sontun peu pluscontraignantes, puisque les referen- 
ces avant sont interdites (la circularite directe ou indirecte etant absurde, die reste evi- 
demment interdite). Un programme XSLT est un document XM L, et en tant quetel, un 
arbreXM L lui est associe. Cequi veut dire que la structure d'un programme XSLT est 
une structure deblocsjuxtaposesou imbriquesavolonte. Les regies devisibilite, pourles 
variables locales, sont eel I es qui sont traditionnellement adoptees pour les langages a 
structure de blocs : unevariabledeclareedansun bloc nepeutetrereferenceequedansle 
meme bloc, ou dans n'importequel bloc plus interne (cette regie est neutre vis-a-vis des 
references avant : I 'interdiction ou I'autorisation des references avant vient en plus). 

Remarque 

(.'interdiction des references avant est un peu contradictoire avec la nature declarative et fonctionnelle du 
langage XSLT. En tout cas, elle n'etait pas necessaire ; on peut penser qu'elle a ete decidee parce qu'elle n'a 
rien de tres contraignant, et qu'elle facilite notablementla lecture du programme. 

Les regies devisibilite des variables locales sont done une combinaison de la regie des 
blocs et de celle des references avant; cela peut se resumer graphiquement, en faisant 
apparaitre les instructions XSLT comme des blocs numerates, et en montrant, pour une 
declaration de variable donnee, quels sont les blocs ou une reference a cette variable est 
autorisee (voir figure 5-5). 

Terminons en remarquant que I 'allusion aux langages a structure de blocs n'est pas abso- 
lument necessaire pour decrire les regies devisibilite en XSLT : XPath donneevidem- 
ment tout le vocabulaire adequat pour decrire ces regies sans parler de bloc. II suffit de 
dire que si on prend comme nceud contexte le nceud contenant la declaration d'une va- 
riable locale, alors les nceuds oil une reference a cette variable est autorisee sont tous les 
nceuds de I 'axe f oi i owi ng-si bi i ng, ainsi que tous leurs descendants. 

Conflits de noms de variables 

II y aconflitdenom, si aun endroit donned' un programme XSLT, il y aau moinsdeux 
variables de meme nom simultanement visibles. 

Un conflit de nom entre deux variables globales est interdit, de meme qu'entre deux 
variables locales. 

M ais un conflit de nom est autorise entre une variable globale et une variable locale. 
Dans ce cas, la variable locale masque la variable globale ; la valeur de la variable glo- 
bale n'est done pas disponible a I'endroitdu conflit. 
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Les instructions xsi :variabie et xsi :param sont deux instructions voisines, tant sur le 
plan syntaxique que semantique. L'une declare une variable, et I 'autre un parametre, 
c'est-a-dire quelque chose d'assez semblable a un argument formel de fonction dans un 
langage comme C ou Java. La difference essenti el I e entre variable et parametre est 
qu'une variable est declaree par une instruction qui lui donne sa valeur, alors qu'un para- 
metre est declare par une instruction qui ne lui donne qu'une valeur par defaut. 

Les parametres suivent exactement les memes regies de visibilite que les variables, et les 
memes conflits de noms peuvent survenir, avec exactement les memes consequences et 
conclusions que ceux qui concernent des variables. 

Deplus, etant donne la similitude entre variable et parametre, des conflits de noms croi- 
ses peuvent apparaitre, mettant en jeu une variable et un parametre, et pas seulement 
deux variables ou deux parametres. M ais a nouveau, la nature exacte (variable ou para- 
metre) des elements mis en jeu n'intervient pas ici, et ce cas se ramene a un conflit de 
nom entre deux variables. 

Bande-annonce 

Debut d'une feuille de style 

xml version="1.0" encoding="UTF-16"?> 
si :stylesheet 

xml ns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1' /> 
<xsl:param name="monnaieUsuelle" select=" ' FF"7> 

<xsl :value-of select="$monnaiellsuelle"/> 

Lancement du processeur XSLT 



java com. icl.saxon. Stylesheet 

-o produits.txt produits.xml produits.xsl monnaieUsuelle=DM 

La valeur du parametre monnaieusueiie est fourni dans la ligne de commande lors du 
lancement du processeur X SLT. L a valeur ff associee a ce parametre dans le programme 
XSLT n'est qu'une valeur par defaut. 



Syntaxe 
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A utre possibilite 








xsl :p«ram 








<xsl:param name 




."> 




<!-- modele 


de 


tra 


nsforn 


. . . texte o 


u in 


str 


uctio 


<!-- fin du 


modele 


de t 


</xsl :param> 








instruction xsi 


par 


am 


)euta 


On voitquexsi -.\ 


ari 


abl 


eetx 



peut apparaitre comme instruction de premier niveau, 
pa ram partagent la meme syntaxe. 



Semantique 

Un parametre peutetre local ou global. S'il est local, il joue le meme rolequ'un argu- 
ment formel de fonction en C ou Java. S'il est global, il joue le meme role qu'un 
argument formel de la fonction main en C ou Java, c'est-a-dire qu'il permet de recuperer 
les arguments qui ont pu etre fournis lors du lancement du programme XSLT (mais le 
standard X SLT ne sped fie pas de quelle facon on peut transmettre des arguments au pro- 
gramme XSLT lors de son lancement). 

Lavaleurassocieeaun parametre lors desa declaration est une valeur par defaut, qui ne 
sera prise en compte que si aucune valeur n'est fournie lors de I'appel. 

Utilisation d'un parametre global 

Reprenons I'exemple vu a la section Utilisation d'un TST-texte pour le calcul de la 
valeur par defautd'un attribut, page 206, danslequel une variable servait a fai re I 'expan- 
sion de la valeur par defaut d'un attribut. Nous voulons maintenant que la monnaie par 
defaut ne soit plus codee en dur dans le programme, mais qu'elle soit parametrable en 
fonction des executions : 



2ncoding="UTF-16"? 



produits.xsl 

<?xml version-"].. 
<xsl: stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 
version="1.0"> 

<xs1:output method='text' encoding-' ISO-8859-1' /> 

<xsl:param name-"monnaieUsuelle" select-" ' FF"7> 

<xsl :template match="Li vre"> 

<xsl :variable name="monnaie"> 
<xsl :choose> 

<xsl :when test="Prix/@monnaie"> 

<xsl :value-of select="Prix/@monnaie"/ 
</xsl :when> 
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<xsl :otherwise> 




<xsl :value-of select="$monn 


ieU 


</xsl :otherwise> 




</xsl:choose> 




</xsl:variable> 




ref: <xsl :value-of select="@ref"/> 




prix: <xsl:value-of 




select="Prix/@valeur"/> <xsl:valu 


J-Of 


si :template> 




lrtemplate match="text( )"/> 




tylesheet> 





Si on lance I 'execution decettefeui I lede style sans sepreoccuperdefournir unevaleur 
au parametre monnaieusuei i e, on obtient le meme resultat que precedemment (voir Uti- 
lisation d'unTST-textepour lecalcul dela valeur par defautd'un attribut, page 206) : 



Cela est da a ce que le parametre monnaieusueiie a pris sa valeur par defaut (« FF »), 
etantdonne qu'on nelui a pasdonne de valeur expliciteau lancementdu programme. 
Pour fournir unevaleur au parametre monnaieusuei i e, il faut se reporter a la documenta- 
tion duprocesseurXSLT que I 'on utilise. U n cas si mpled' utilisation est eel ui ouon lance 
le programme via une ligne de commande sur le systeme hote (commande DOS sous 
Windows, commande shell sous Unix, etc.) ; dans ce contexte, la documentation fournie 
avec Saxon nousditceci : 

Using Saxon from the Command Line 

va com. icl .saxon. Stylesheet [options] source-document stylesheet [pararas...] 

e options must come first, then the two file names, then the params. 

param takes the form name=value, name being the name of the parameter, and value 
e value of the parameter. These parameters are accessible within the stylesheet 
normal variables, using the $name syntax, provided they are declared using a 
p-level xsl:param element. If there is no such declaration, the supplied parameter 
lue is silently ignored. 

II suffit done defaire comme indique, e'est-a-dire de lancer le programme comme ceci 
(la ligne de commande est bien sflr d'un seul tenant, meme si la mise page la coupe en 
deux) : 
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Ligne de commande 

Java com. icl .saxon. Stylesheet -o produits.txt produits.xml produits.) 
monnaieUsuelle=DM 

Etvoila le travail : 
Resultat 

ref: vernesl 



Ce qui correspond bien a ce qu'on attendait. 

Saxon n'estpasleseul processeurdu marche; maistousfournissentun moyendedefinir 
des valeurs de parametres via la ligne de commande ; par exemple, avec X alan, on aurait 
a lancer la commande suivante, pour obtenir le meme resultat : 

Ligne de commande 

Java org. apache. xalan.xslt. Process -IN produits.xml -XSL produits.xsl -OUT 
produits.txt -PARAM monnaieUsuel le DM 

Utilisation d'un parametre local 

L'utilisation d'un parametre local est vraiment tres differente de celle d'un parametre 
global. On I'a vu, les parametres globaux servent a recuperer des arguments de la ligne 
de commande, fournis sous forme de paires (nom, valeur), d'une maniere qui n'est 
d'ailleurs pas specified par le standard XSLT. Si I'on n'a pas pour but une quelconque 
recuperation d'argument, mieux vaut, dans ce cas, utiliser une variable globale qu'un 
parametre global, car ^utilisation d'un parametre global suggere I'intention de trans- 
mettre un argument. 

Rien detoutcela pour un parametre local, qui, nousl'avonsdit, correspondrait plutot a la 
notion d'argument formel de fonction, meme si la notion de fonction n'existe pas a pro- 
prementparler en XSLT. 

II est done impossible d'aller plus loin dans la comprehension des parametres locaux, 
sans allerfaireun tour du cote des model esnomme's(<xsi : tempi ate name="...">)etdes 
appels de modeles nommes (<xsi : can -tempi ate name="...">), que nous allons voir 
maintenant. 



Instruction xshtemplate 

XSLT estun langagede transformation d'arbre. A cetitre la structure la plus importante 
du langage est sans aucun doutela regie, qui, associeeau moteurde transformation, per- 
met la transformation effective d'un arbreou d'une partie d'arbre. 
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Une regie est associee a un modele de transformation, qui consiste (en general) en une 
sequence de plusieurs transformations elementaires (par exemple, un xsl:value-of, suivi 
d'un autre xsl:value-of, suivi d'un xsl : if). Certaines sequences peuvent revenir a I'iden- 
tique dans plusieurs regies differentes, de meme que dans un programme en C, par 
exemple, une meme sequence d'instructions peut se retrouver a differents endroits du 
traitement. Dans les deux cas, I 'idee naturelle est alors de factoriser la sequence com- 
mune, etdelui donner un nom ; celadonneunefonction en C ou en Pascal, etun modele 
nomme en XSLT. 



La factorisation de code est la motivation la plus ancienne pour justifier I'emploi de fonctions ;il est evident qu'il 
y en a d'autres, ne serait-ce que le decoupage d'un code monolithique en petites unites semantiques plus fades 
acomprendreetamaintenir. Cela vautbien sur aussi pourXSLT. 

Un modele nomme et une regie s'expriment tous les deux a I'aide d'une instruction 
xsi template ; ce qui les differencie d'un point de vuesyntaxique, c'est que pour une 
regie, on specifie un attri but match=" . . . ", alors que pour un modele nomme, on specifie 
un attri but name=- . . . ", et on ne specirie pas d'attribut match. M ais rien n'interdit de spe- 
cifier les deux attri buts match et name simultanement : dans ce cas, on a une regie nom- 
inee, c'est-a-dire un hybride qui peut etre selectionne comme une regie, ou appele 
comme un modele nomme. 



Bande-annonce 



Le modele nomme ci-dessous instancieun textefourni en parametre, en I'accompagnant 
d'un sautdeligneetd'un tiret. 



cml version="1.0" encoding="UTF-16"?> 

;1: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" vers1on="l.C 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl : tempi ate name="instancierTexteAvecTi ret"> 

<xsl:param name="texte"/> 

- <xsl :value-of select="$texte" /> 
</xsl:template> 



<xsl :template match="Nom"> 

<xsl : cal 1 -template name="ins 
<xsl :with-param name="te 
</xsl : cal 1 -template> 

</xsl :template> 

<xsl :template match="text( )"/> 
</xsl:stylesheet> 



ierTexteAvecTi r< 
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Concert.xml 

<?xml version="1.0" encoding="UTF-16" standalor 



<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensembl 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 



<Interprete> 








<Nom> Sylvia Abra 




:z </Nom> 




<Instrument>Basse 


de 


iole</In 


St 


</Interprete> 








<Interprete> 








<Nom> Benjamin Pe 


rot 


</Nom> 




<Instrument>Theorbe e 


Guitare 


b 


</Interprete> 









iroque</Instrument> 



<TitreConcert> 

Folies d'Espagne et diminutions d' Italic 
</TitreConcert> 

<Compositeurs> 

<Compositeur>M. Marais</Compositeur> 
<Compositeur>D. Castello</Compositeur> 
<Compositeur>F. Rognoni</Compositeur> 

</Compositeurs> 



Leresultatobtenu estdonne ici en anticipant sur la prochaine instruction qui seravueun 
peu plus loin (voir la section Instruction xskcall-template, page 229). 



Jonathan Dunford 
Sylvia Abramowicz 
Benjamin Perrot 
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Syntaxe 



Model e nomme xsl : tempi ate 

si :template nan 



argu 



;nts formels du model e nomme - 



fin des arguments formels du modele 
corps du modele de transformation -■ 

fin du corps du modele de transform! 
</xsl :template> 

Argument formel du modele nomme 
| <xsl :param name="..."/> 



Argument formel du modele nomme (avec 

<xsl:param nane="..." select=" . . .expre 



aleur par defaut) 

ion XPath.../> 



valeur par defaut) 



Variante d' argument formel du modele nomme (a\ 

<xsl :param name=" . . . "> 

<!-- modele de transformation du parametre --> 

<!-- fin du modele de transformation du parametre --> 
</xsl :param> 

instruction xsi template est une instruction de premier niveau ; il est done impossible 
de declarer un modele nomme a I'interieur d'un autre modele nomme. 

Les arguments formels sont facultatifs, mais s'ils sont presents, ils doivent etre places en 
premier, avant le debut du corps du modele de transformation. 



Modele nomme typique 

U n modele nomme aura souvent la forme suivante : 

si : tempi ate name=". . ."> 



<xsl 



;="truc"/> 



<xsl:param name="machin"/> 
<!-- corps du modele de transfor 
... reference a $truc ... refere 
<!-- fin du corps du modele de t 
</xsl :templ ate> 



Semantique 



U n modele nomme est i nstancie exactement comme peut I 'etre un modele de transforma- 
tion associe a une regie (e'est-a-di re un modele de transformation « ordinaire », comme 
tous ceux que nous avons vu jusqu'a present). 
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La seule chose qui difference I'instanciation d'un modele de transformation « ordi- 
naire » de celle d'un modele de transformation nomme, c'est la nature de I'evenement 
declencheur : dans le premier cas, c'est la selection d'une regie choisie par le moteur 
XSLT (apres recherche de concordance de motif) ; dans le deuxieme, c'est un appel 
explicite, du style : instancier le modele « tartampion » en lui fournissant les arguments 
« true » et « machin ». 

Mais une fois I'evenement declencheur passe, et I'instanciation en cours, plus rien ne 
distingue les deux types demodelesde transformation. Done tout ce qui aete vu dans a 
la section I nstanciation d 'un modele de transformation relativement a un no>ud courant 
etunelistecourante, page 90, reste valable pour I'instanciation d'un modele de transfor- 
mation nomme. 



Exemple 



N ous supposerons ici que nous voulons realiser un site Web d'annonces de concerts, pre- 
sentees en francaisou en anglais. Une solution estdedupliquer lesite, afin d'en avoir une 
version franchise et une version anglaise. M ais c'est evidemment la mauvaise solution 
(maintenance en double, et risque d'incoherenceentre les deux versions). Unemeilleure 
solution consiste a maintenir un seul site, et a mettre en place un systeme de traduction 
automatique. Ici, la traduction automatiqueestenvisageable, car lesite necontientaucun 
texte redactionnel : uniquement des noms propres (de personnes ou de vi I les), des dates 
etdesnomsd'instruments. 

L'idee est done de maintenir uniquement un fichier XML contenant les informations a 
publier, etde mettre au point un programmeXSLT qui va generer lecodeHTM L tout en 
assurant la traduction. 

Afin de ne pas surcharger I 'exemple, nous nous contenterons de montrer comment rea- 
liser la traduction, en laissantde cote la generation decode HTML, qui n'a rien de parti - 
culierement original ni interessant. 

Enfin, la traduction reposant sur un dictionnaire, il serait logique de penser que ce dic- 
tionnaire constitue un fichier XML separe, maintenu independamment du fichier XML 
des annonces. Cela implique I ''utilisation de la fonction predefinie standard document ) 
poury acceder ; nous ferons done d'abord lechoix, un peu artificiel, il estvrai, de placer 
ce dictionnaire dans une variable globale codee en dur dans le programme XSLT. A ce 
titre, cet exemple constituera un complement interessant a eel ui etudiea la section Utili- 
sation d'unTST obtenu litte'ralement(XSLT 1.1 ou plus), page 199. Ensuitenous verrons 
comment uti I isercette fonction standard documento. 

Voici le fichier XML des annonces : 



2ncoding="UTF-16" standalone="yes"?> 



annonces 


.xml 


<?xml \ 


-ersion= 


<Annonc 


:es> 


<Annonce> 



Les instructions de programmation 



<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date> 

<Jour id="jeu'7> 

<Quantieme>17</Quantieme> 

<Mois id="jnv'7> 

<Annee>2002</Annee> 

<Heure>20H30</Heure> 
</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument id="bvl"/> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 

instrument id="bvl"/> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument id="thb"/> 
</Interprete> 

<Interprete> 

<Nom> Freddy Eichelberger </Nom> 

<Instrument id="clv"/> 
</Interprete> 

<Concert> 

<TitreConcert lang="fr"> 

Folies d'Espagne, Bourrasque et Tourbillor 
Gavotte La Ferme - Chaconne de Rougeville 

</TitreConcert> 

<TitreConcert lang="en"> 

Spanish folias, Squall and Whirlwind 
Gavotte Shut Up - Redtown's Sillycate 

</TitreConcert> 
</Concert> 

<Compositeurs> 

<Compositeur>Marin Marais</Compositeur> 
<Compositeur>Jean de Sainte Colombe</Compositf 

</Compositeurs> 



</Annonce> 
<!-- autres 
</Annonces> 



Instruction xshtemplate 

Chapitre 5 



Etvoici le programme XSLT : 



annonces.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 
version="l.l"> <!-- compatibil ite Saxon 6.5 --> 

<xsl:output method='text' encoding=' ISO-8859-1 ' /> 

<xsl :param name="langueCible">fr</xsl :param> 

<xsl :variable name="Dictionnaire"> 

<mot id="bvl"> 

<traduction lang="fr">Basse de viole</traduction> 
<traduction 1 ang="en">Bass viol</traduction> 

</mot> 

<mot id="vdg"> 

<traduction lang="fr">Viole de gambe</traduction> 
traduction lang="en">Viola da gamba</traduction> 

</mot> 

<mot id="lth"> 

traduction lang="fr">Luth</traduction> 
<traduction lang="en">Lute</traduction> 

</mot> 

<traductior 
<traductior 
</mot> 

<mot id="flt"> 

<traduction lang="fr">Flute a bec</traductic 
<traduction lang="en">Recorder</traduction> 

</mot> 

<mot id="thb"> 

<traductiot 

<traductiot 
</mot> 

<traduction lang="fr">l undi</traduction> 
traduction lang="en">monday</traduction> 
</mot> 
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<mot id="dim"> 

traduction 1 ang="fr">dimanche</traduction> 
<traduction 1 ang="en">sunday</traduction> 

</mot> 

<mot id="jnv"> 

traduction 1 ang="fr">janvier</traduction> 
<traduction lang="en">january</traduction> 

</mot> 

<!-- etc. (les autres mois de l'annee) --> 

traduction lang="fr">decembre</traduction> 
traduction 1 ang="en">december</traduction> 

</xsl:variable> 

<xsl :template name="traduction"> 



variable 

ime="motTrouve" 

5lect="$Dictionnaire/mot[@id=$motId]" /> 



name="saTraduction" 
select="$motTrouve7traduction[@lang=$langueCible]" /> 

<xsl:value-of select="$saTraduction" /> 
</xsl :template> 

<xsl : tempi ate match="Date"> 

<xsl :cal 1 -template name=" traduction'^ 

<xsl:with-param name="motId" select=" ./Mois/@id" /> 

</xsl :call-template> 
</xsl :template> 

<xsl :template match="Interprete"> 

-<xsl:value-of select=" ./Nom'7> : 

<xsl :cal 1 -tempi ate name="traduction"> 

<xsl :with-param name="motId" select=" ./Instrument/@id" /> 
</xsl :cal 1 -template> 
</xsl :template> 

<xsl :template match="text( )" /> 

</xsl: stylesheet) 
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La structure de ce programme XSLT est tres simple : un parametre global donnant la 
langue cible pour la traduction, une variable globale contenant la description X M L du 
dictionnaire, un modelenomme prenanten donneeun identifiantdemot, etinstanciantsa 
traduction dans la langue cible, et final ement deux regies, une pour I es dates, et une pour 
les instrumentistes, uti I isantchacune I eservi cede traduction offert par I e modelenomme. 

Le modelenomme recoiten donneeun identifiantdemot. Son instanciation commence 
par la constitution d'un node-set (variable motTrouve) contenant tous les elements <mot> 
du dictionnaire qui sont tels que leur attri but id soit egal a I'identifiant de mot recu en 
donnee; normalement, si le dictionnaire est bien fait, le node-set obtenu ne doit pas 
contenir plus d'un element; etsi le mot que Ton chercheatraduireexisteeffectivement 
dans le dictionnaire, le node-set contient au moins un element. 
L e node-set contient done finalementun etun seul element, un <mot>. 
L'instanciation du modele nomme se poursuit avec la constitution d'un node-set (va- 
riable saTraduction) contenant tous les elements <traduction> enfants directs du nceud 
unique selectionne a I'etape precedente, tels que I 'attri but lang de chacun d'entre eux 
soit egal a la langue cible ; la encore, si le dictionnaire est bien construit, il n'y a qu'un 
seul element repondantaucritere. Le node-set obtenu contient done un etun seul element 

<traduction>. 

L'instanciation du modele nomme se termine avec l'instanciation de I 'instruction 
xsi :vaiue-of, qui en I'occurrence, est remplaceepar la valeur textuelledu node-set ne 
contenant que cet unique element <traduction>, e'est-a-dire la valeur textuelle de cet 
unique element lui-meme. 



En general, ce n'est pas tres pertinent de faire calculer la valeur d'un node-set quelconque parxsl:value-of, car 
seul le premier nceud est pris en compte : les autres sont carrement ignores. Mais ici, il n'y a pas de question a se 
poser, puisque le node-set possede par construction un et un seul element : il n'y a done pas de perte en ligne. 

Reste a expliquer I'appel du modele nomme dans les deux regies qui I ' uti I i sent. Mais 
pour ca, il nous faudra regarder de plus pres I'instruction xsi : can -tempi ate, ce que 
nous ferons a la section suivante. En attendant, voici comment utiliser la fonction 
documento pour externaliser le dictionnaire dans un fichierXM L secondaire. 

Le dictionnaire sera place dans un fichier "dictionnaire.xmi" ; I'instruction a changer 
est bien sur I 'initialisation de la variable Dictionnaire : 

<xsl: variable name="Dictionnaire" select="document( 'dictionnaire.xmi ' )/Dictionnaire'7> 

L a fonction document ( ) peut etre appelee sous diverses formes, et nous aurons I 'occasi on 
de voir d'autres exemples d'appel ; celui montre ci-dessus est un des plus simples pos- 
sible : I'argument est une chaine de caracteres representant I'URL du fichier a lire. Le 
fichier doit etre au format XM L ; il est lu, converti en arbreXM L, et la fonction renvoi e 
un node-set contenant uniquement la racinede I 'arbre. Notez bienqu'il s'agitdelaracine 
del'arbre, etnon de la racinedu document. Done si I'on veutque la variable Dictionnaire 
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contienne comme dans la version precedente un node-set constitue de tous les <mot>, il 
faut I 'initialiser avec I'expression : 

document ( 'dictionnaire.xml ' )/Dictionnaire 

etnon passeulement: 

document ( 'dictionnaire.xml ' ) 

Une amelioration possible serait que le nom du fichier fourni comme argument de la 
fonction document o ne soit qu'une valeur par defaut, la vraievaleuretant fourni e comme 
parametredansla lignedecommande. On aboutirait alors a la version finale suivante: 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns :xsl="http: //www. w3.org/1999/XSL/Transforir 



<xsl:output method='text' encodings' ISO-8859-1' /> 






ime="Dictionnaire" 

;1 ect= " document ( $d i coFi leRef )/ Diet i or 



variable 

rame="motTrouve" 

;elect="$Dictionnaire/mot[@id=$motId]" /> 

variable 

iame="saTraduction" 

;elect="$motTrouve/traduction[@lang=$langueCible]" /> 



<xsl:value-of select=" 


isaTraducti 


</xsl :template> 




<xsl :template match="Date" 




<xsl :call -template na 


e="traduct 


<xsl :with-param na 


e="mot!d" 


</xsl : call -tempi ate> 




</xsl :template> 





i1ect="./Mois/@id" /> 



<xsl rtemplate match="Interprete"> 

-<xsl:value-of select=" ./Nom"/> : 

<xsl :call-template name="traduction"> 

<xsl :with-param name="motId" select=" ./Instrument/@id"/> 
</xsl :call -template> 



Instruction xshcall-template 

Chapitre 5 



</xsl :template> 

<xsl : tempi ate match="text( )" /> 
</xsl:stylesheet> 

Le fichier dictionnaire reprend les donnees qui se trouvaient auparavant dans la variable 

Dictionnaire : 



dictionnaire. xml 






<?xml version="1.0 


• encod 


ng="UTF-16" standalone="yes"?> 


<Dictionnaire> 






<mot id="bvl"> 






<traductio 


n lang= 


fr">Basse de viole</traduction> 


<traductio 


n lang= 


en">Bass viol</traduction> 


</mot> 






<mot id="vdg"> 






<traductio 


n lang= 


fr">Viole de gambe</traduction> 


<traductio 


n lang= 


en">Viola da gamba</traduction> 


</mot> 






<!-- etc. ... 


(comme 


vant) --> 


<mot id="dcb"> 






<traductio 


n lang= 


fr">decembre</traduction> 


<traductio 


n lang= 


en">december</traduction> 


</mot> 






</Dictionnaire> 







Apres ce petit detour par la fonction document o, nous revenons maintenant au propos 
initial, I'appel d'un modele nomme. 

Instruction xshcall-template 

instruction xsi : can-template permet de lancer I'instanciation d'un modele nomme. 



Bande-annonce 



Voir la bande-annonce de I 'instruction <xsi : tempi ate name=- . . . -> (voir Bande-annonce, 
page 220). 



Syntaxe 



xsi : call -tempi ate 

<xsl :cal 1 -tempi ate name=" . . . "> 

<!-- arguments effectifs pour I'appel ■ 
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<!-- fin des arguments effectifs pour l'appel --> 
</xsl: call -tempi ate>/> 

Argument effectif 

<xsl:w1th-param name-"..." select-"... expression XPath ..." /> 

Variante d' argument effectif 

<xsl :with-param name="..."> 

<!-- modele de transformation de Targument effectif --> 

irgument effectif --> 

L'instruction xsi : can -tempi ate ne doit pas apparaitre en tant qu'instruction de premier 
niveau. 

Semantique 

LorsdeSOn instanciation, ^instruction <xsl : call -tempi ate>. . .</xsl : call -tempi ate> 

est remplacee par sa valeur, qui n'est autre que celle resultant de I 'instanciation du 
modele nomme (voir figure 5-6, qui montre sur I'exemple precedent quelle peutetre la 
valeur d'instanciation d'un appel de modele nomme). 

ProgrammeXSLT 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl:stylesheet 

xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 
xmlns:saxon=" http://icl.com/saxon" 

<xsl:output method='text' encoding='ISO-8859-l'/> 
<xsl:param name="langueCible">fr</xsl:param> 



Annonces 
An nonce. 







<xsl:call-templatena 
<xsl:with-param 

select =" ./I nstrument/@ id" / 
</xsl :cal I -tempi ate> 



Valeur d'instanciation possible pour un appel de modele nomme. 
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L'instanciation du modele nomme se passe en deux temps : 

(1) les arguments effectifs sont evalues, et donnent leur valeur aux arguments formels. 
S'il y a un argument effectif dontlenom ne correspond aaucun argument formel, il 
est tout simplement ignore, et ce n'est pas une erreur ; s'il y a un argument formel 
dont le nom ne correspond a aucun argument effectif, sa valeur par defaut entre en jeu 
etlui donnesa valeur. 

(2) la valeur de tous les arguments formels etant connue, I e modele nomme est alors ins- 
tance comme n'importe quel autre modele de transformation : tout se passe comme 
si les arguments formels etaient des variables dedarees au debut du modele, avec une 
valeur precisement egale a celle qui vient d'etre calculee (voir figure 5-7). On est 
done ramene a l'instanciation d'un modele de transformation comportant des decla- 
rations de variables locales, que nous avons deja vue a la section Utilisation d'une 
variable, page 184. Lors de l'instanciation, le noeud courant et la liste courante res- 
tent identiques a ce qu'ils etaient au moment du cai i -tempi ate, ce qui permet d'eva- 
luer les expressions X Path contenues dans le modele nomme comme si el les avaient 
ete directement ecrites dans le modele contenant I 'appel can -tempi ate. 

Les appels recursifs ne sont pas interdits ; mais comme d'habitude en pareil cas, il faut 
s'assurer que I 'appel recursif ne va pas engendrer de recursion infinie. 

Note 

Au cas ou vous ne seriez pas a I'aise avec la recursion, reportez-vous au chapitre sur les patterns de program- 
mation, qui donne quelques rappels sur la recursion, montre comment I'utiliser, dans quels cas I'utiliser, etsitue 
son importance relativementaux autres notions ou techniques propres aXSLT. 



Exemple 

Tous les elements sont maintenant reunis pour que I'exemple vu a la section Exemple, 
page 223, soit completement analysable ; ils sont resumes a la figure 5-7. 
On lance le programme XSLT comme ceci : 

Ligne de commande 

[ Java com. icl .saxon. Stylesheet -o annonces.txt annonces.xml annonces.xsl 

Etvoici le resultat obtenu : 

Resultat 

Janvier 

- Jonathan Dunford : 
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M odele 



Fragment de 
document resultat 



I nstanciation du E valuation de 

template I'argument 

(2) motld 

/ <« 



recopie 
evalue 
recopie 

1+2+3+4+5+6 



^ 



les deux etapesdel 
xslxall-template 



<xsl:variable name= "motld" select='"bvl'"/> 



name="saTraduction" 
select="saxon:node-set($motTrouve)/ 
traduction[@lang=$langueCible]" / 

<xsl:value-of select="$saTraduction" /> - 



Figure 5-7 

Les stapes de I 'instantiation d'un appel demodelenomme. 
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- Benjamin Perrot 
Theorbe 



- Freddy Eichelberger 



On lance le programme XSLT commecela : 

Ligne de commande (une seule ligne d'un seul tenant) 



jav. 
la 



va com. icl .saxon. Stylesheet -o annonces.txt annonces.xml annonces.xsl 
ngueCible=en 



Etvoila leresultat: 
Resultat 



- Jonathan Dunford 
Bass viol 



- Sylvia Abramowicz 

Bass viol 

- Benjamin Perrot : 



- Freddy Eichelberger 
Harpsichord 



Instruction xshapply-templates 

instruction xsi :appiy-tempiates a deja ete vue (voir section Instruction xshapply- 
templates, page 131) ; nous la revoyons ici a cause du fait qu'une regie et un modele 
nomme peuvent donner un hybride (voir Instruction xshtemplate, page219). Une regie 
pouvant declarer des parametres, il est done logique que la regie selectionne puisse en 
recevoir. 

Syntaxe 

xsi :apply-templates 

<xsl :apply-templates select="..." mode="..."> 
<!-- arguments effectifs pour 1'appel --> 

<!-- fin des arguments effectifs pour 1'appel --> 
| </xsl :apply-templates>/> 

Argument effectif 

<xsl :with-param name="..." select="... expression XPath ..." /> 
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Van ante d' argument effectif 

<xsl :with-param name="..."> 

<!-- modele de transformation de 1 'argument effectif --> 

|<l— fin du modele de transformation de 1 'argument effectif --> 
</xsl :with-param> 

L'instruction xsi :appiy-tempiates ne doit pas apparaitreen tant qu'instruction de pre- 
mier niveau. Lesattributsmode et select sontfacultatifs. 



Semantique 

Laseulechosenouvelleestla presence des arguments effectifs (xsi :with-param) dansle 
modele de transformation dexsi :appiy-tempiates. S'il y a des parametres, ilssonteva- 
lues et transmis aux regies selectionnees. Ce n'est pas une erreur si I'une d'elles ne prend 
pas d'argument en donnee, et ce n'est pas non plus une erreur si I'une d'elles prend en 
donnee un parametre qui n'est pas transmis. 

J 'avoue m'etre creuse la tete pour trouver un exemple interessant de transmission de para- 
metre a une regie XSLT par I 'intermediate d'une instruction <xsi :appiy-tempiates>. 
Sans resultat sur le moment ; mais en faisant tout autre chose, je suis tombe sur un cas ou 
c'est vraiment utile. Rendez-vous done a la section Pattern n° 18 - Localisation d'une 
application, page 533 pour un exemple illustrant cette notion. 

Instruction xshmessage 

L'instruction xsi :message affiche un message et eventuellement, arrete I 'execution du 
processeurXSLT. 



Syntaxe 

xsi :message 



;!-- modele de transformatior 



<!-- fin du modele de transformatior 
</xsl :message>/> 



xsi :message (variante syntaxique) 

<xsl :message terminate="yes"> 

<!-- modele de transformation -■ 



<!-- fin du modele de transformatior 
</xsl:message>/> 



L'attribut facultatif terminate^..." peut recevoir deux valeurs possibles: yes ou no. 
La valeur no est la valeur par defaut. 
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L'instruction > 
niveau. 



;age ne doit pas apparaitre en tant qu'instruction de premier 



Semantique 

L'instanciation de l'instruction <xsi :message> se traduit par I'instanciation de son 
modele de transformation, qui est ensuite sorti quelque part de telle sorte que I 'util isateur 
puisse le voir. Cela peut etre par exemple une boite d'alerte, la sortie standard d'erreur, 
ou autre (le standard XSLT nespecifiepas la nature exactede la sortie). 

En general, le modele de transformation contient uniquement du texte, mais I e standard 
ne I'impose pas. Rien n'interdit que des elements XML soient instancies, mais que 
pourra bien faire une boite d'alerte de texte balise en XML? 

L es messages sont general ement des messages d'erreur, mais ce n'est pas une obligation. 
Lorsque I'attribut terminate est present avec la valeur yes, I'execution du processeur 
X SLT s'arrete apres la sortie du message, et le document resultat en cours de constitution 
est mis a la poubelle. 

Le fait que la sortie utilisee pour un message nesoit pas bien definieen reduitun peu la 
portee. Avec Saxon, par exemple, le message est affiche sur la sortie standard d'erreur ; 
on peut done I'utiliser en complement de <xsi :comment> pour faire du depistage 
d'erreurs : <xsi :message> pour attirer I'attention sur le fait qu'une condition anormale 
estsurvenue, et <xsi :comment> pour afficher la trace sans perturber la sortie quand tout 
va bien. M ais si les messages sortent dans des boites d'alerte, cela peut devenir tres vite 
exasperant de devoir les refermer sans arret. 

Instruction xshkey 

L'instruction xsi :key etablit une declaration d'association entre des nceuds d'un arbre 
XML source et des valeurs. 

Bande-annonce 



Dictionnaire 


xml 


<?xml versi 


on="l. 


<Dictionnai 


re> 


<mot id 


="dim" 


<tr 


aducti 


<tr 


aducti 


</mot> 




<tr 


aducti 


<tr 


aducti 


</mot> 




</Dictionna 


ire> 



2ncoding="UTF-16" standalor 



'">dimanche</traduction> 
i">sunday</traduction> 



lang="fr">lundi</traduction> 
lang="en">monday</traduction> 
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Declaration de cle 

<xsl:key name="traduction" match="mot" use="attribiite: :id" /> 

Apres avoir declare la cle, on peut utiliser la structure obtenue grace a la fonction keyo, 
a qui I'on transmet le nom de la cle , ainsi que la valeur de cle. Ellerenvoieun node-set 
qui contientleou lesnceudsqui ontete attaches a cette valeur par une declaration decle 
comme celle montree ci-dessus (voir figure 5-8, page 236). 



<Mot>Qun] 




Figure 5-8 

Utilisation d 'une cle 



<xsl variable name-'unM ot" select ="key('traduction', lun 1 ) "/> 



<xs1:key name="..." match=". . .motif .. ." use=" .. .expression. .. "/> 

L'instruction xsi : key est une instruction de premier niveau, et de premier niveau unique- 
ment. 
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Ni le motif, ni I 'expression, ne peuvent contenir des references a des variables ou des 
appels a la fonction predefinie keyo. Les instructions xsi :key sont evaluees avant les 
variables global es. Ces restrictions ont pour but d'empecher d'eventuelles circularites. 

Semantique 

instruction xsi :key declare une cle. 

Une cle possede un nom et associe des valeurs a des noeuds. Le nom est fourni par 
I'attribut name, et les noeuds concerned sont ceux (d'un certain arbre XM L source) qui 
concordent avec le motif de I'attribut match ; quand un nceud concordeavec le motif, sa 
valeur-cle est celle qui resulte de devaluation de I'expression donnee par I'attribut use, 
en prenant ce noeud comme nceud contexte. 

Remarque 

Notez ce point extreme merit important : I'arbre XML source dans lequel serontcherches les noeuds concordants 
n'est pas determine, instruction xsi : key ne fait rien, en elle-meme. Son effet sur le processeur XSLT est 
simplement de lui demander de noter au passage les trois attributs name, match, et use, mais pas d'effectuer 
une recherche ni de construire une table d'associations. 

instruction xsi :key ne s'utilise jamais seule, car son instanciation ne produit rien. De 
memequ'une declaration de variable xn'ade sens que si une reference $x a cette variable 
existe quel que part, dememe une instruction xsi :key n'a de sens que par rapport a ('uti- 
lisation de la fonction predefinie key( ). 

Dans le cas le plus simple, lorsd'un appel a la fonction key(N, V), on transmeten argu- 
ment le nom N de la cle (qui doit se retrouver en tant qu'attribut name d'une instruction 
xsi :key), etunevaleurV de type string. Untel appel intervientnecessairement dans une 
expression, ou un nceud contexte est defini, puisqu'un nceud contexte est touj ours defini 
pour devaluation d'une expression. Ce nceud contexte fait partie d'un arbre XML 
source; cetarbreXML source est eel ui qui sera explore pour determiner les associations 
nceuds/valeurs. L'effet est le suivant : 

• la table des associations pour cette cle N etce document source est construite, amoins 
que cela ne soit deja fait (a cause d'un precedent appel) ; 

• le node-set des noeuds associes a la valeur V est extrait de cette table, et renvoye 
comme resultat. 

Le temps perdu a construire la table peutetre largement regagne ensuite car lesacces aux 
node-sets par leur valeur-cle sont quasi ment instantanes, en tout cas independants du 
nombre de noeuds de I 'arbre XML source. 

Ceci etant, il y a maintenant deux aspects essentiels et complementaires a voir, e'est la 
maniere dont cette fameuse table est construite, et celle dont ell e est exploited 
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Remarque 

Pour etre honnete, il faut signaler ici que tout ce qui vient d'etre explique est assez eloigne de la presentation 
faite par le standard XS LT, qui ne parle absolument pas de table, ni de sa construction, ni de temps gagne, ni de 
temps perdu ; qui ne dit pas que I'instruction xs 1 : key ne fait a peu pres rien, ni ne dit que c'est I'appel a la fonc- 
tion key( ) qui declenche tous les traitements. En fait, le standard se place a un niveau plus abstrait, contraire- 
ment aux explications donnees ici, qui font reference a des techniques d'implementation, notamment par table 
associative. Neanmoins, il est tres difficile de se figurer le fonctionnement du couple instruction xsl : key /fonc- 
tion key() sans avoir un modele de traitement present a I'esprit pour guider la pensee. Le modele de traitement 
presente ici, a base de table associative, n'est pas impose par le standard, mais il va tellementde soi qu'il est 
difficile d'imaginerun processeurXSLT s'en ecartantfondamentalement. 

De toute fajon, cette presentation des choses centree surl'emploi d'une table associative n'est pas fonctionnel- 
lement fausse : au pire, on peut dire qu'une implementation pourrait legitimement reposer sur des techniques 
totalement differentes, a condition que I'effet obtenu soit le meme, abstraction faite des questions de perfor- 
mance etde rapidite d'acces. 



Construction et exploitation de la table associative 

Uneclepossedeun nom etassocie des valeurs a des nceuds : on a done affaire a une rela- 
tion ternaire entre des, valeurs et nceuds, dont le but est d'indexer des nceuds par des 
valeurs. Le modele presente figure 5-9 resume eel a graphiquement. 



Figure 5-9 

L 'association cle 
valeur, nom. 




Le modele de la figure 5-9 se lit comme ceci : 

• il y a une action « A ssocie» (c'est une association) ; 
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• unecle est I'agent decette action (c'est elle qui fait Taction) ; 

• une val eur est I 'objet decette action (c'est a elle que I 'action s'applique) ; 

• un nceud estun autre objet decette action (c'est aussi alui quel'action s'applique). 
Lesnombres« 1 » et « l+» (1 ou plus) indiques sont les cardinalites ; ellesselisentainsi : 

• unecle peut etre I'agent de une ou pi usieurs associations; 

• une association a pour agent une seule cle ; 

• une valeur peut etre I 'objet de une ou pi usieurs associations ; 

• une association peut avoir pour objet une ou pi usieurs val eurs; 

• un noeud indexe peut etre I'objetde une ou pi usieurs associations; 

• une association peut avoir pour objet une ou plusieursnceuds indexes. 

Dans la pratique, toutes ces combinaisons peuvent se produire, nous verrons eel a sur des 
exemples. 

Lors d'un appel a la fonction key ( ), le noeud contexte de I 'expression englobante est fixe. 
Ce noeud contexte designe implicitement I'arbre X M L a explorer pour construire la table. 
D'autre part, le premier argument de I'appel est le nom de la cle : il faut done trouver 
^instruction xsi :key dont I'attribut name a pour valeur ce nom. L'ayant trouvee, on a 
alorsun motif ( attri but match) et une expression ( attri but use). Si on n'en trouveaucune, 
c'est une err eur, maissi on en trouve pi usieurs, on n'en rejetteaucune; nous verrons pi us 
bas ce qu'on en fait. Pour I 'instant, nous continuons en supposant que I 'on a trouve exac- 
tement une instruction xsi :key. 

La construction de la table d'association implique une exploration complete de la total ite 
des noeuds de I'arbre source : pour chacun d'eux, on teste sa concordance avec le motif. 
S'il n'y a pas concordance, le noeud est ignore ; s'il y a concordance, I'expression est 
evaluee en utilisant ce noeud comme noeud contexte. devaluation de cette expression 
peut donner un node-set ou non : 

• Si leresultatn'estpasun node-set, il estconverti en string, et cette valeur est la valeur 
de la cle. Le noeud concordant est done range dans la table, associe a cette valeur de 
cle. 

• Si le resultat est un node-set, la valeur textuelledechaque noeud est calculee ; cesdif- 
ferentes val eurs textuel les sont autantde val eurs-cle pour le noeud concordant, qui est 
done range dans la table, associe a chacune de ces valeurs. 

Si on trouve plusieurs instructions xsi :key de meme valeur d' attri but name, la table est 
construite en utilisant le motif et I'expression de la premiere instruction trouvee, puis 
chaque instruction xsi: key supplemental re donne un nouveau motif et une nouvelle 
expression, qui donne lieu a une nouvelle exploration de I'arbre source : la table est sim- 
plement mi sea jour en yajoutant les nouvel les associations qui decoulentde chaque nou- 
velle exploration. 
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En deuxieme lecture, il pourra etre interessantde faire le rapprochemententre les figures qui arriventmaintenant 
(figures 5-10, 5-11, 5-12 et 5-13) et la figure 8-1 de la section Pattern n'9 -Identitede nceuds et node-set de 
valeurs toutes differentes, page 434. 

Une association d'une valeura un nceud 

C'est la situation la pi us simple; el I e est resumee dans I a figure 5- 10, qui montre la struc- 
ture logique de la table d'association, construite a partir du fichier Dictionnaire.xmi 
(voirci-dessous) etde la declaration : 

Declaration de cle 

<xsl:key name="traduction" match="mot" use="attribute: :id" /> 




.root 


( ,<Dictionnaire> 




i<Mot>[rJTm] 


<traduction> <traduction> 




Sunday] 


dimanche 



Figure 5-10 

U ne association d 'une valeur a u 
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Dictionnaire.xml 



<?xml version="1.0' 


encoding="UTF-16"?> 


<Dictionnaire> 




<mot id="dim"> 




traduction 


lang="fr">dimanche</traduction> 


<traduction 


lang="en">sunday</traduction> 


</mot> 




</Dictionnaire> 




traduction. xsl 





<?xml version="1.0" encoding="UTF-16"?> 

<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" ve 

<xs1:output method='text' encoding=' ISO-8859-1' /> 

<xsl:key name="traduction" match="mot" use="attribute: :id" /> 





<xsl :template name="afficher"> 










<xsl:param name="code"/> 










<xsl :variable name="mot" select="key( 


traducti 


on'. 


$code)"/> 




<xsl :for-each select="$mot/traduction 


> 








<xsl :value-of select="$code"/Xxs 


:text> ( 


</x 


si :text> 




<xsl:va1ue-of select="@lang"/Xxsl 


:text> ) 




/xsl:text> 




<xsl :val ue-of select 3 ". "/> 










<xsl:text> 








</x 


si :text> 









</xsl :template> 

<xsl : tempi ate match="/"> 

<xsl :cal 1 -tempi ate name="afficher"> 

<xsl :with-param name="code" select=" 'dim"7> 

</xsl: call -tempi ate> 
</xsl :templ ate> 

<xsl template match="text( )"/> 
</xsl:stylesheet> 
Resultat 

dim ( fr ) : dimanche 
dim ( en ) : Sunday 

Lorsdel'appel a la fonction keyo, lenoeudcontexteestlaracinedel'arbreXML source 
(car I'instruction can -tempi ate ne change pas le nceud contexte courant) ; done e'est cet 
arbre qui est explore pour construire la table. 

Voyons maintenant comment evolue la table si I 'on rajoute une entree dans le diction- 
naire. 
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Deux associations, avec une valeur et un nceud par association 
Nousreprenonsexactementla meme declaration decle, maisavec un dictionnaire a deux 
entrees : 

Dictionnaire.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Dictionnaire> 
<mot id="dim"> 

traduction 1 ang="fr">dimanche</traduction> 
<traduction lang="en">sunday</traduction> 
</mot> 
<mot id="lun"> 

<traduction lang="fr">l undi</traduction> 
traduction lang="en">monday</traduction> 
</mot> 
</Dictionnaire> 

La figure 5-11 resume graphiquement ce que cela donne. 




Figure 5-11 

Deux associations, avec une valeur etun n«ud par association. 
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traduction.xsl 

<xsl : tempi ate match="/"> 
<xsl : call -tempi ate nair 
<xsl:with-param na 
</xsl:call -template) 
<xsl :cal 1 -tempi ate narr 
<xsl :with-param na 
</xsl:call -template) 
</xsl : tempi ate> 
... idem ... 

Resultat 

dim ( fr ) : dimanche 

dim ( en ) : Sunday 

lun ( fr ) : lundi 

lun ( en ) : monday 



Deux associations, avec deux valeurs et un nceud par association 
Nousgardonsici lememedictionnaire, mais nous changeons la declaration decle : 

Declaration de cle 



Chaque <mot> du dictionnaire concorde avec le motif ; pour chacun d'eux, I'expression 
evaluee est done : 



Cette expression selectionne pour chaque <mot> un node-set de deux elements, puisqu'il 
y a deux traductions par mot. Done ici, chaque mot va etre associe a deux valeurs, qui 
sontles valeurs textuellesdes elements <traduction>. La figure 5-12 resume celagraphi- 
quement. 

traduction.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl:key name="traduction" match="mot" use="traduction" /> 

<xsl : tempi ate name="afficher"> 
<xsl:param name="unMot"/> 

<xsl :variable name="motTrouve" select="key( 'traduction' , $unMot)"/> 
<xsl :variable name="sonCode" select="$motTrouve/@id"/> 

<xsl :for-each select="$motTrouve/traduction"> 
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<xsl:value-of select="$sonCode'7Xxsl :text> ( </xsl:text> 
<xsl:value-of select="@lang"/Xxsl :text> ) : </xsl:text> 
<xsl:value-of select=".'7> 
<xsl :text> 
</xsl:text> 

</xsl:for-each> 
</xsl :template> 



<xsl :template match="/"> 

<xsl: call -tempi ate name="afficher 
<xsl :with-param name="unMot" 
</xsl : call -tempi ate> 
<xsl :cal 1 -template name="afficher 
<xsl :with-param name="unMot" 
</xsl :cal 1 -template> 
</xsl :template> 

<xsl :template match="text( )"/> 

</xsl:stylesheet> 



?lect="'dimanche"7> 



:lect=" 'monday ' "/> 



ot>Qun] 




Figure 5-12 

Deux associations, avec deux valeurs et un neeud par association. 
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Resultat 




dim ( fr ) 
dim ( en ) 
lun ( fr ) 
lun ( en ) 


dimanc 

lundi 
monday 



Remarquer ici que la determination du mot se fait non plus par son code, mais par sa 
valeur francaise ou anglaise. 

Deux associations, avec une valeur et deux nceuds par association 

N ous gardons ici le meme dictionnaire, mais nous changeons a nouveau la declaration de 

cle: 

Declaration de cle 

<xsl:key name="traduction" match="traduction" use="@lang" /> 

Pour chaque element <traduction>, I 'expression "@iang" nedonnequ'uneseule valeur. 
Mais il setrouvequeplusieurselementsontla meme valeur d'attribut lang ; on vaalors 
construire une table dont la structure logique est resumee par la figure 5-13. 




Figure 5-13 

Deux associations, avec une valeur etdeux n^uds par association. 
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traduction.xsl 



(ml version="1.0" encoding="UTF-16"?> 

;1 stylesheet xmlns :xsl="http://www. w3.org/1999/XSL/Transform" versior 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl:key name="traduction" match="traduction" use="@lang" /> 

<xsl :template name="afficher"> 
<xsl:param name="langue"/> 
<xsl variable name="traductionsTrouvees" select="key( 'traduction' 



5-of select="$langue 





<xsl:text> 




</xsl:text> 






<xsl :text>l_angue = </ 


Sl :text><xsl : 


</x 


si :text> 






<xsl:for-each select= 


StraductionsT 




<xsl 


value-of select=". "/> 




<xsl 


text> ( code 


: </xsl:text> 




<xsl 


value-of select="../@id"/> 




<xsl 


text> ) </xs 


:text> 




<xsl 


text) 




</x 


si :text> 
</xsl:for-each> 




</x 


si :template> 




<xs 


1 rtemplate match="/"> 






<xsl icall-template nan 


e="afficher"> 




<xsl :with-param n 


me="langue" s 




</xsl : call -tempi ate> 






<xsl : cal 1 -template nan 


e="afficher"> 




<xsl :with-param n 


me="langue" s 




</xsl : cal 1 -template> 




</x 


si :templa 







<xsl :template match="text( )"/> 
</xsl:stylesheet> 



Resultat 



Langue = en : 

Sunday ( code : dim ) 
monday ( code : lun ) 
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Construction d'une table a partird'un document XML auxiliaire 
Nous avons deja ditque I'arbreXM L explore lors de la construction de la table est celui 
qui contient le nceud contexte, lors de I 'evaluation de I'expression XPath donnant une 
valeur-clea I 'association. Si cen'estpas I 'arbre source XM L principal, cela peutetreun 
TST lie a une variable, ou un arbre fourni par la fonction documents ), qui construit un 
arbre secondai re d'apresun fichierexterneXM L. Danstouslescas, il faut pouvoir chan- 
ger de nceud contexte demaniere a changer d'arbre explore. Or il n'y a qu'uneseule ins- 
truction capable de changer temporal rem ent le noeud contexte, c'est I'instruction 
xsi :for-each. Done si Ton veut que la table d'association soit construite a partir d'un 
arbre XML qui n'est pas I 'arbre principal, I'appel a la fonction keyo devra necessaire- 
mentfairepartiedu modelede transformation d'une instruction xsi :for-each adequate. 

L'exemple vu a la section Deux associations, avec une valeur et un no>ud par associa- 
tion, page 242 pourrait etre repris comme ceci, en supposant que le document principal 

n'aitrien a VOiraveC Dictionnaire.xml : 

traduction .xsi 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl:key name="traduction" match="mot" use="attribute: :id" /> 



<xsl :for-each select="document( 'Dictionnaire.xml ' )"> 

<xsl :variable name="mot" select="key( 'traduction' , $code)"/> 

<xsl :for-each select="$mot/traduction"> 

<xsl :value-of select="$code"/Xxsl :text> ( </xsl:text> 
<xsl:value-of select="@lang"/Xxsl :text> ) : </xsl:text> 
<xsl:value-of select="."/> 
<xsl :text> 
</xsl:text> 

</xsl:for-each> 
</xsl:for-each> 
</xsl :template> 

<xsl :template match="/"> 

<xsl:call -tempi ate name="afficher"> 

<xsl:with-param name="code" select=" 'dim"7> 
</xsl: call -tempi ate> 
<xsl :cal 1 -template name="afficher"> 

<xsl :with-param name="code" select=" '1 un"7> 
</xsl:call -template) 
</xsl :templ ate> 
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|<xsl:template match="text( )"/> 
</xsl:stylesheet> 

Resultat 

dim ( fr ) : dimanche 

I dim ( en ) : Sunday 

lun ( fr ) : lundi 

lun ( en ) : monday 

Variante 

II y a une variante possible pour I'appel delafonction keyo, Elleconsisteatransmettre 
comme deuxieme argument un node-set NS au lieu d'une String. Mais ce n'est rien 
d'autre qu'unefacilite syntaxique : celarevientaappelern foislafonction keyo avec la 
valeur textuelle de chacun des nceuds du node-set N S en deuxieme argument, et a prendre 
comme resultat global, I'union ensembliste de chacun des n node-sets renvoyes separe- 
ment. 

Exemples 

Les exemples classiques, en matiere de manipulation de cles, concernent les references 
croisees (Pattern n° 13 -Generation d 'hyper liens, page 468, Pattern n°12 - Re'fe'rences 
croisees interveners, page459), les regroupements (Pattern n°14 - Regroupements, 
page 474), les constitutions de node-sets d'elements tous differents suivant un certain 
critere (Node-set de valeurs toutes diffe'rentes, page 438). 

M ais rien n'interdit d'utiliser une cle dans des domaines pas du tout classiques : seule 
I'imagination, en dernier ressort, peut nous I i miter. 
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Les instructions de creation sont celles qui produisentdu texte dans I e document resultat, 
sans qu'il s'agisse de texte provenant de la transformation d'elements du source XML 
traite par le programme X SLT. 

Nous commencerons par ^instruction <xsi:text>, qui permet de regler Remission 
d'espaces blancs dans le document resultat, et accessoirement, de controler I'habillage 
ou le deshabillage de caracteres speciaux normalement proteges dans leur carapace 
XML. 

Ensuite, nous reviendronssur I 'utilisation d'un element source I itteral a contenu calcule 
pour creerdu texte XM L dans le document resultat. Nousavionsdejavu cela (voir Utili- 
sation d'un TST calcule (XSLT 1.1 ou plus), page 203), mais ici nous en verrons une 
forme plus evoluee, permettant de parametrer les valeurs de certains attributs, grace a la 
notion dedescripteur de valeur differ <?e d'attribut (A ttributeValue Template). 

Puis nous verrons les instructions X SLT permettant de produire du texte XML (elements 

et attributs) ; CeSOnt les instructions <xsl :element>, <xsl :attribute>, et <xsl :attri- 

bute-setx Ces instructions peuvent paraitre un peu inutiles, etantdonne les possibilites 
offertes par les elements source litteraux, telles qu'on les aura vues. Neanmoins, nous 
verrons qu'il y a des cas ou elles sont indispensables, notamment lorsque les noms des 
balisesXM L qui doiventfigurer dans I e document resultat ne sont pas connusau moment 
ou on ecritle programme. 

Dans le meme ordre d'idee, viendront enfin les instructions permettant de sortir des 
commentaires XML ou des processing-instructions XML ; ce sont les instructions 

<xsl :comment>, et <xsl : processi ng-i nstructi on>. 
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Instruction xshtext 

Bande-annonce 

L'instruction <xsi :text> est souvent utilisee pour placer des espaces blancs significatifs 

dans le programme source XSLT. Dans I'exemple ci-dessous, c'est un saut de lignequi 
est place : 



Nom.xsl 

<?xml 



version="1.0" encoding="UTF-16"?> 

tylesheet xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 



<xsl:output method='text' encodings' ISO-8859-1 ' 

<xsl :templ ate name="insererSautLigneApresTexte"> 
<xsl:param name="texte"/> 
<xsl:value-of select="$texte" /> 
<xsl:text> 
</xsl:text> 

</xsl :template> 



<xsl :templ ate match="Nom"> 
<xsl :cal 1 -template name=' 
<xsl :with-param name= 
</xsl :cal 1 -template> 

</xsl :template> 

<xsl :template match="text( )\ 
</xsl:stylesheet> 



'erSautLigneApresTexte") 



Concert.xml 

<?xml versic 



="1.0" encoding="UTF-16" standalc 



<Entete> Les Concerts d'Anacreon </Ent§te> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 



<Ensemble> "A deux vio' 



?s" </Ensemble: 



<Interprete> 

<Nom> Jonathan Dunford </Mom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abr 
<Instrument>Bass 
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</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Compositeur>M. Marais</Compositeur> 
<Compositeur>D. Castello</Compositeur> 
<Compositeur>F. Rognoni</Compositeur> 

</Compositeurs> 

</Concert> 

Resultat 

Jonathan Dunford 
Sylvia Abramowicz 
Benjamin Perrot 



Syntaxe 



<xsl:text> 

<!-- modele de transformation --> 

... texte brut (pas de texte XML et encore moins XSL) ... 

<!-- fin du modele de transformation --> 
</xsl:text> 

L'i instruction xsi :text nedoitpasapparaitreen tantqu'instruction de premier niveau. 

Semantique 

instruction xsi :text ne peut contenir que du texte non balise (done aucune instruction 
XSLT ne peut apparaitre comme enfant d'un element <xsi :text>, ni meme du texte 
XML d'un domaine nominal different de "xsi :"). 

L'instanciation decette instruction consisted recopier le texte de son modele de transfor- 
mation dans le document resultat. II n'y a pas vraiment besoin d'instruction xsi :text 
pour faire 9a, puisque e'est le fonctionnement normal de toute instanciation de tout 
modele de transformation : le texte brut qui s'y trouve est recopie dans le document 
resultat. 

M ais I 'instruction xsi : text trouve sa raison d'etre lorsqu'elle ne contient que des espaces 
blancs (dans ce cas on est siir que ces espaces blancs seront pris en compte, et recopies 
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dans le document resultat), ou lorsqu'elle contient du texte sans espace blanc (dans ce 
cas, on est sfir qu'il n'y aura pas d'espace blanc parasite ajoute au document resultat) : 
s'occuper des espaces blancs, tel est le role (officieux) devolu a cette instruction. 

Exemple 

Nous reprenons ici I'exemple vu a I'occasion de instruction xsi :choose (voir Instruc- 
tion xskchoose, page 174), dans lequel il y a un probleme de repartition des espaces 
blancs dans le document a produire (I 'exemple se trouve a la section E xemple, page 176). 
Le fichier resultat que I'on avait obtenu etait le suivant : 
Resultat 



flute a bee 






Michel Keustermans et Laur 


a Pok 




viole d'amour 






Vinciane Baudhuin 






oboe da caccia 






Blai Justo 






viole de gambe 






Rika Murata , Martin Bauer 


. Sophie 


Wati 


Benoit vanden Bemden 






orgue positif et clav 


ecin 





Jacques Willemijns 

On admettra facilement que ce n'est pas totalement satisfaisant, et qu'il serait mieux 
d'avoirquelque chose commececi : 



Resultat 








flute 


d'amour • 


~hel Keustermans et 
/inciane Baudhuin. 


Laur 


Pok 


oboe 


da caccia : 


Blai Justo. 






viole 


de gambe : 


Rika Murata, Marti 


n Bau 


r, S 


violo 


ie : Benoit 


vanden Bemden. 






orgue 


positif et 


clavecin : Jacques 


Willemijn 



M aisavant devoir comment I'instruction xsi :text va pouvoir intervenir pour resoudre 
le probleme, il faut comprendre ce qui se passe exactement. 

D'une maniere generale, des qu'il y a des problemes d'espaces blancs dans un document 
resultat, les questions a se poser sont les suivantes : 

• Y a-t-il des espaces blancs en trop? Si oui, proviennent-ilsdu fichier source XML ou 
du programme XSLT ? 
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• Manque-t-il desespaces blancs? Si oui, il fautintervenir surle programme XSLT (et 
non passur I efichier source XM L), et dans ce cas, il n'y a rien demieux que I 'instruc- 
tion xsl :text. 

S'il y a desespaces blancs en trop, quefaire? Leseliminer, bien sur. 

M ais la facon d'eliminer des espaces blancs en trop n'est pas la meme suivant qu'ils pro- 
viennentdu fichier source XML oudu programme XSLT lui meme: 

• Ceux qui proviennent du fichier source XML seront broyes par la fonction standard 

normal ize-space() OU par I 'instruction <xsl :strip-space>. 

• Quant a ceux qui proviennent du programme XSLT, instruction xsi:text pourra a 
nouveau faire quelque miracle. 

Note 

L'instruction <xsl :strip-space> a ete vue a I'occasion de I'instruction <xsl :if> (voir la section Exemple, 
page 170). 

Reste a savoir comment faire pour determiner I'origine d'un espace blanc, que rien ne 
distingue a priori d'un autre. 

Le principe est simple: il faut mettredes marqueurs dans le programme XSLT, et voir 
comment se situent les espaces blancs en trop par rapport aux marqueurs. 

Prenons par exemple les espaces blancs indesi rabies qui se trouvent entre « flute a bee » 
et le caractere « : », et ceux qui se trouvent entre « : » et « M ichel », dans le document 
resultat montre ci-dessus, et essayons de determiner leur origine par des marqueurs. 
L e programme est eel ui -ci (sans changement par rapport a ce qu'on avait a la section I ns- 
truction xshchoose, page 174) : 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 

<xsl : tempi ate match="Role"> 

<xsl:value-of select=" ./child: :text( )"/> : 
<xsl :choose> 

<xsl :when test="count( ./Interprete) = 1 "> 
<xsl :value-of select="Interprete"/> 



<xsl :when test="count( ./Interprete) = 2 "> 
<xsl :val ue-of select="Interprete[l]"/> e 
select="Interprete[2]"/> 



I Les instructions de creation 



lect="Interprete"> 

; select="."/Xxsl:if test="not(position( ) = 
last())">, </xsl:if> 



<xsl :template match="text( )"/> 
</xsl:stylesheet> 

Le caractere « : » present juste apres ^instruction xsi :vaiue-of constitue deja en lui 
memeun marqueur. Lesespacesblancsqui setrouvententre«fluteabec»et« : » pro- 
viennent done necessairement du fichier source X M L . On va les supprimer avec un appel 

a normal ize-space( ) : 

<xsl:value-of select="normal ize-space( ./child: :text( ) )"/> : 

Cette fonction elimine tous les espaces blancs situes en debut et en fin de la chaine de 
caracteres donnee, et remplace toute sequence interne d'espaces blancs par un seul . Dans 
notre cas, la donnee a traiter se presente comme ceci (ou les « \n » et « \t » designent res- 
pectivement le caractere de fin de ligne et de tabulation) : 

<Role>\n 
\t \t \t \t viole de gambe\n 
\t \t \t \t <Interprete> 

lei, la fonction normal 1ze-space() va remplacer la Chaine "\n\t\t\t\tv1o1e de gambe\ 
n\t\t\t\t" par "viole de gambe". 

La regie devient celle-ci : 

<xsl :template match="Role"> 

<xsl:value-of select="normal ize-space( ./child: :text( ) )"/> : 



<xsl :when test="count( ./Interprete) = 1 "> 

<xsl :value-of select="Interprete'7> 
</xsl :when> 

<xsl:when test="count( ./Interprete) = 2 "> 

<xsl:value-of select="Interprete[l]"/> et <xsl:' 
select="Interprete[2]"/> 
</xsl :when> 
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<xsl :otherwise> 

<xsl :for-each select="Interprete"> 

<xsl:value-of select="."/Xxsl :if test="not(posiotion( ) 
last())">, </xsl:if> 
</xsl:for-each> 
</xsl:otherwise> 

<sl :choose> 



</xsl :template> 

Etvoici cequeceladonne : 

Resultat 

flute a bee : 

Michel Keustermans et Laura Pok viole d'amour : 

Vinciane Baudhuin oboe da caccia : 

Blai Justo viole de gambe : 

Rika Murata, Martin Bauer, Sophie Watillon violone : 

Benoit vanden Bemden orgue positif et clavecin : 

Jacques Willemijns 

Tous les espaces blancs situes avant chaque nom d'instrument ont ete supprimes (ce qui 
entraine la perte des sauts de ligne). Reste a voir les espaces blancs qui sont situes apres 
lescaracteres« : ». 

Plagons le marqueur « ! » avant le nom de chaque premier artiste de chaque ligne : 

<xsl : tempi ate match="Role"> 

<xsl:value-of select="normal ize-space( ./child: :text( ) )"/> : 



<xsl :when test="count( ./Interprete) = 1 "> 

Kxsl :value-of select="Interprete'7> 
</xsl:when> 

<xsl :when test="count( ./Interprete) = 2 "> 

!<xsl:value-of select="Interprete[l]"/> et <xsl :val ue-of 
select="Interprete[2]"/> 
</xsl:when> 

<xsl: otherwise) 

Kxsl :for-each select="Interprete"> 

<xsl:value-of select^" . VXxsl :if test="not(position( ) 
last())">, </xsl:if> 
</xsl:for-each> 
</xsl :otherwise> 

</xsl :choose> 

</xsl :templ ate> 
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Michel Keustern 



? Baudhuin oboe da c 



i Justo viole de gambe 



! Rika Murata, Marti r 



! Benoit vanden Bemden orgue positif et c 



Clairement, les espacesblancs en tropsont dans le programme XSLT. C'estvrai toutefois 
que I'espace entre le « ! » et la premiere lettre de chaque ligne provient necessai rement 
du fichier X M L . M ais le gros de la troupe provient du fichier X SLT. 

Par ailleurs, on constate qu'il manque un saut de ligne avant chaque nom d'instrument, 
depuisquenousavonsmisen service la fonction normal ize-space(), etqu'un nouveau 
saut de ligne est apparu avant chaque « ! » depuis que nous avons place ce marqueur. 

La contre-experience pourrait consister a enlever le marqueur « ! » (qui ne sert plus a 
rien maintenant qu'il aditcequ'il avait a dire), eta en mettreun (parexempleune«* ») 
devant chaque nom d'instrument: 



<xsl :template 


match="Role 


*<xsl:valu 


e-of select= 


<xsl:choo 


se> 



<xsl:when test="count( ./Interprete) = 1 "> 

<xsl :value-of select="Interprete"/> 
</xsl :when> 

<xsl:when test="count( ./Interprete) = 2 "> 
<xsl:value-of select="Interprete[l]"/> t 
select="Interprete[2]"/> 
</xsl :when> 



<xs 


:otherwise> 




<xsl <J s ° 1 r :^l e ! 




</xsl:for-each> 


</x 


1 :otherwise> 


</xsl:C 




1: tempi 


te> 



>elect="Interprete"> 

ect="."/Xxsl:if test="not(position( ) = 
t())">, </xsl:if> 
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*flute a bee : 
Michel Keuster 



*oboe da cacci 

Blai Justo 



r viole de gambe : 
Rika Murata , Martin Bauer , Sophie Watil" 



Benoit vanden Bemden 



*orgue positif et clavecin : 
Jacques Willemijns 

On constate done que la presence du marqueur n'estpasneutre, et qu'elle induit I'appa- 
rition desautsdelignes. 

Pourquoi ? La feuille de style XSL est un document XML, ne I'oublions pas. A cetitre, 
elle est constitute, elleaussi, de noeuds de type text etd'elementsXML. En particulier 
le debut de la premiere regie sepresenteainsi : 

<xsl : tempi ate match="Role">\n 
\n 

\t \t \t *<xsl:value-of select="normal ize-space( ./child: :text( ) )"/> :\n 
\t \t \t <xsl:choose> 

L es « \n » et « \t » designent a nouveau le caractere de fin de I igne et de tabulation. Done, 

entre le nceud <xsl : template match = "Role"> et le nceud <xsl :value-of select="nor- 

maiize-space(./chiid::text( ))"/>, il y aun noeud text, dont la valeur est la chalne de 
caracteres "\n\n\t\t\t*". OrleprocesseurXSLT traiteles noeuds text presents dans I es 
model es de remplacement de la maniere suivante : 

• si le noeud text ne contient que des espaces blancs, il est elimine (et n'est done pas 
recopie dans le document resultat) ; 

• mais s'il contient au moins un caractere d'une nature differente (qu'il soit place au 
debut, au milieu ou a la fin), alors il est integral ement preserve, et recopie tel quel dans 
le document resultat. 

La presence ou non dece marqueur «* » changecompletementl'alluredu resultat final. 

Si on lemaintient, I a chainede caracteres "\n\n\t\t\t*" est integralementrecopiee dans 
le document resultat; si on le supprime, le noeud text correspondant est elimine, et 
Iteration dueaux espaces blancs disparait. 
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<xsl :template 


match=" 


Rol 




<xsl:text> 






</x 


l:text> 








<xsl rvalue 


-of sel 


ect 




<xsl :choose> 






</xsl:choo 


se> 





La solution n'estdonc pas difficilea obtenir : puisqu'on veutunsautdeligneavantchaque 
nom d'instrument, il suffit de placer un saut de ligne dans une instruction xsi :text. En 
effet, et c'est le propre de cette instruction, meme si le nceud texte qui lui est rattache ne 
contientquedesespaces blancs, il n'estpaselimine. 



ialize-space(./child::text() 



</xsl :template> 

Et puisqu'on ne veut pas changer de ligne apres le caractere « : », il suffit de faire 
en sorte que (1°) le saut de ligne qui se trouve juste apres ne fasse pas parti e du meme 
nceud texte, (2°) qu'il soit seul (avec eventuellement d'autres espaces blancs) dans 
son nceud texte, et (3°) que tout ce beau monde ne soit pas protege par une instruction 

xsl :text. 

II y a deux solutions : dans la premiere, on inclut I e caractere « : » dans une instruction 

xsl :text : 

<xsl :template match="Role"> 



;./child::text())'7> <xsl:text> : </xsl:text> 



Dans la deuxieme, on exclut le saut de ligne du nceud texte contenant le caractere 

« »:« » xsl :text ? 



Note 

[.'instruction xsl : variable, definissant une variable inutile et initialiser avec une String vide seraitaussi pos- 
sible, dans le sens oil cela donneraitle meme resultat, mais il est evident que ce genre d'astuce stupide n'est 



<xsl :template match="Role"> 

<xsl :text> 
</xsl:text> 

<xsl :value-of select= 
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<x 


1 :choose> 


</> 


si :choose> 


/xsl :templ ate> 



:e(./child::text())"/> : 



On arrive done final ement a cette solution (dans laquelle on el i mine les espaces blancs 
sur les noms d'interpretes provenant du fichier XML et on ajoute un « . » a la fin de 
chaque ligne, pour completer la ponctuation) : 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1 ' /> 

<xsl : tempi ate match="Role"> 

<xsl:text> 
</xsl:text> 

<xsl:value-of select="normal ize-space( ./child: :text( ) )"/> : <xsl:text/> 
<xsl:choose> 

<xsl :when test="count( ./Interprete) = 1 "> 

<xsl:value-of select="normal ize-space(Interprete)'7>.<xsl :text/> 
</xsl:when> 

<xsl:when test="count( ./Interprete) = 2 "> 

<xsl :val ue-of select^" normal ize-space( Interpreted ])"/> 

<xsl:text> et </xsl:text> 

<xsl :value-of select="normal ize-space(Interprete[2])"/>.<xsl :text/> 

</xsl :when> 

<xsl :otherwise> 

<xsl :for-each select=" Interpreted 

<xsl :value-of select="normal ize-space( . )"/> 
<xsl:if test="not(position() = last())"> 

<xsl :text>, </xsl:text> 
</xsl:if> 
</xsl:for-each> 
<xsl:text>.</xsl:text> 
</xsl :otherwise> 

</xsl :choose> 

</xsl :templ ate> 

<xsl:template match="text( )"/> 

<sl: stylesheet) 
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Cequi donne(enfin) le resultat attend u : 
Resultat 

flQte a bee : Michel Keustermans et Laura Pok. 

viole d'amour : Vinciane Baudhuin. 

oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Watillon. 

violone : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Willemijns. 

Variante syntaxique 

On peutsi I'on veutajouter un attributed sable-output-escaping, avec la valeur "yes" 
ou "no- ("no" est la valeur par defaut), comme ceci : 

xsl :text 

<xsl :text disable-output-escaping=". . ."> 

... texte brut (pas de texte XML et encore moins XSL) ... 
</xsl:text> 

Semantique 

Employee avec I'attributdisabie-output-escaping, I'instruction xsi :text nesert plus 
(ou plus seulement) a regler des problemes d'espaces blancs, mais a influencer la facon 
dont certains caracteres (comme "<") devront apparaitre dans le document resultat, lors 
de la serialisation de I'arbre resultat. Par principe, ces caracteres sont pudiquement mas- 
ques d'une feuille de vigne XM L (a ne pas confondre avec une feuille de style XSL), et 
apparaissent done sous forme de references de caracteres (comme "&#6o : -) ou de refe- 
rences d'entites (comme "&it : "). Si I'attribut disabie-output-escaping a pour valeur 
« yes », et que le mode de sortie est « html » ou « xml », ils apparaitront alors dans leur 
plus simple appareil (en mode « text », les caracteres sortent toujours « nature » : le pro- 
blemenese pose pas). 

Exemple 

Dans la version precedents nous rempl aeons la ligne : 

<xsl:text> et </xsl:text> 

par : 

<xsl:text disable-output-escaping="no"> & </xsl:text> 

On obtientceci : 
Resultat 
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oboe da caccia : Blai Justo. 

a gambe : Rika Murata, Martin Bauer, Sophie Watillc 

: Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Willemijns. 



ODoe aa ca< 
viole de g; 
viol one : I 



Commeon estici en mode « text », lescaracteresspeciaux sortenttels quels, bien qu'on 
n'ait pas invalide la protection. Pour voir reellement ce que ?a donne, il faut passer par 
exemple en mode «xml » (ce qui n'a aucun sens dans cet exemple, puisqu'il n'y a 
aucunebaliseXML dans I e document resul tat) : 

ProgrammeConcert.xsl 

<?xml version="1.0" encoding="UCS-2"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='xml ' 

encodings' ISO-8859-1' /> <!-- mode xml active ici !!! --> 

<xsl :template match="Role"> 

<xsl:text> 
</xsl:text> 

<xsl :value-of select="normal i 
<xsl:choose> 



C./child::text())"/> 



<xsl :when test="count( ./Interprete) = 1 "> 

<xsl :val ue-of select=" normal ize-space(Interprete)"/>.<xsl :text/> 
</xsl:when> 



</: 



<xsl:text disable-output-e 
<xsl :val ue-of select="norn 
tsl :when> 



-space ( Interpreted] )"/> 

ig="no"> & </xsl:text> 

-space( Interpreted] )"/>.<xsl :text/> 



<xsl :otherwise> 

<xsl :for-each select=" Interpreted 

<xsl :value-of select="normal ize-space< 
<xsl:if test="not(position() = lastO 

<xsl:text>, </xsl:text> 
</xsl:if> 
</xsl:for-each> 
<xsl:text>.</xsl:text> 
</xsl :otherwise> 

</xsl :choose> 

</xsl :template> 

<xsl:template match="text( )"/> 

</xsl:stylesheet> 
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<?xml version="1.0" encoding="IS0-8859-l"?> 

flDte a bee : Michel Keustermans & Laura Pok. 

viole d'amour : Vinciane Baudhuin. 

oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Watillon. 

violone : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Willemijns. 

Maintenant, nousbasculons la valeurdel'attributdisabie-output-* 

<xsl:text disable-output-escaping="yes"> & </xsl:text> 



<?xml version="1.0" encoding="IS0-8859-l"?> 

flute a bee : Michel Keustermans & Laura Pok. 

viole d'amour : Vinciane Baudhuin. 

oboe da caccia : Blai Justo. 

viole de gambe : Rika Murata, Martin Bauer, Sophie Watil' 

violone : Benoit vanden Bemden. 

orgue positif et clavecin : Jacques Willemijns. 



Creation de texte XML par un element source litteral 

Nous allons ici reutiliser une technique deja vue (voir Utilisation d'un TST calcule 
(XSLT 1.1 ou plus), page 203), qui consiste a cabler dans un element source litteral a 
contenu calcule, lastructureXML quel'on veutobtenir : 



xs 


l:template match="Concert"> 
<xsl :variable name="mouvem 


nt"> 












<in 


sert> 
<Ensemble> 
















<NomXxsl :valu 
<Di recti onXxs 

</Ensemble> 

<Concert> 

<DateXxsl:val 
<VilleXxsl:va 


-of s 
:valu 

e-of 
ue-of 


lect=' 
-of se 

elect= 


NomEnsembl e"/X/Nom> 
lect="Chef"/X/Direction> 

"Date"/X/Date> 
= "Ville'7X/Ville> 






<LieuXxsl:val 


e-of 


elect= 


"Sail 


e"/X/Lieu> 








<TitreXxsl:va 


ue-of 


select 


= "TitreConcert"/X/Ti 


ure> 






</Concert> 














</i 
</xsl:v 


nsert> 
ariable> 














<xsl:CO 


py-of select="$mouvement" 


> 








/x 


sl :templ 


ate> 













Unefois instance, I 'element source litteral <insert> donneunTST (Temporary Source 
Tree) dont la serialisation produitceci dans le document resultat: 
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instantiation de ce modele 



<insert> 




<Ensemble> 




<Nom>.. 


</Nom> 


<Direct 


on>...</Direction> 


</Ensemble> 




<Concert> 




<Date>. 


.</Date> 


<Ville> 


..</Ville> 


<Lieu>. 


.</Lieu> 


<Titre> 


..X/Titre> 


</Concert> 





On a done ici non pas une simple transformation d'un arbre source existant, mais bien 
une creation de fragment d'arbre entierement nouveau. 

Remarquez toutefois qu'on est dans un cas simple, ou seuls les contenus textuels des 
elements sont susceptibles de varier ; mais on peut se demander ce qui se passerait si 
certains elements devaienteux-memesdependrede la source XM L a trailer. 

II y a plusieurs degres de variabilite pour un element : 

• lenom d'un attributou d'un element dependede la source XM L, mais les valeurs pos- 
sibles sont a choisir parmi n valeurs connues au moment d'ecrire le programme ; 

• la valeur d'un attri but depend delasourceXML ; 

• lenom d'un attributou d'un element dependede la source XML sans restriction. 

Seuls les deux premiers cas sont a la porteede la technique del 'element source litteral a 
contenu calcule; le troisieme necessite I'emploi des instructions <xsi :eiement> ou 
<xsi :atn'but>, quel'on verra plusbas. 

Le premier cas ne met rien de nouveau en ceuvre ; il suffit de combiner I'emploi d'ele- 
ments source litteraux et d'instructions <xsi :choose>. 

Le deuxieme est plus coriace, comme nous allons maintenant nous en rendre compte. 
L'exemplechoisi estassezclassique, e'est la fusion de sources X M L . La fusion dedeux 
documents XML, par exemple, consiste a en produire un troisieme, constituant d'une 
maniere ou d'une autre une synthese des deux autres. 

II s'agira ici de creer un document XM L, dont la structure sera fournie par un element 
source litteral a contenu calcule, exactement comme dans I'exemple ci-dessus; le 
contenu des elements sera preleve dans I'un des deux documents X M L, et la valeur des 
attri buts de ces elements sera prelevee dans I 'autre. 



Exemple 



Nous allons supposer que nous devons preparer un document de travail pour un recitant 
qui aura a declamer un texte pendant I 'execution d'une certaine piece pendant un concert. 
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Les documents de basesont d'une part letextede la declamation (fichier deciamation- 
Taiiie.xmi) et d'autre part la listedes numeros de mesure ou doiventsesituer les inter- 
ventions du recitant (fichier synopsisRecitant.xml) : 



Note 

Ce texte a ete ecrit par Marin Marais (probablement un douloureux souvenir personnel, I'operation de la taille 
etant une extraction de calculs de la vessie, avec une priere en guise d'anesthesie) pour accompagner I'une de 
ses pieces de viole, publiee apres sa mort Sa veuve avait censure ce texte en le supprimantde la gravure offi- 
cielle (actuellement encore disponible en fac-simile), mais des copies ontcircule, et I'une d'entre elles nous est 
parvenue. La graphie en est curieuse, mais elle n'avait rien d'extraordinaire a une epoque ou I'orthographe 
(notion d'ailleurs totalement anachronique, on parlait plutot de grammaire) se reduisait en gros aux regies 
d'accord, eta des regies d'usage tres liberates, autorisantde nombreuses variations laissees au libre arbitre du 
scripteur. 



deel amati onTa 11 1 e . xml 

<?xml version="1.0" encoding="UTF-16"?> 
<texte> 

<reference> 

Pieces de viole du 5 - livre, 1725 

Marin Marais 
</reference> 

<titre> 

Le Tableau de 1 'Operation de la Taille 

</t1tre> 

<paroles> 

<p>L'aspect de 1 'apareil .</p> 

<p>Fremissement en le voyant.</p> 

<p>Resolution pour y monter.</p> 

<p>Parvenu jusqu'au hault;</p> 

<p>descente dudit apareil. </p> 

<p>Reflexions serieuses.</p> 

<p>Entrelassement des soyes 

Entre les bras et les jambes.</p> 

<p>Icy se fait 1 " incision .</p> 

<p>Introduction de la tenette.</p> 

<p>Ici Ton tire la piere.</p> 

<p>Icy l'on perd quasi la voix.</p> 

<p>Ecoulement du sang.</p> 

<p>Icy l'on oste les soyes. </p> 

<p>Icy l'on vous transporte dans le lit.</p> 

</paroles> 
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synopsisRecitant.xml 

<?xml version="1.0" e 
<synopsisRecitant> 

<prologue/> 



<NoMesure>K/NoMesure> 
<NoMesure>8</NoMesure> 
<NoMesure>lK/NoMesure> 
<NoMesure>15</MoMesure> 
<NoMesure>20</NoMesure> 
<NoMesure>22</NoMesure> 
<NoMesure>23</NoMesure> 
<NoMesure>27</NoMesure> 
<NoMesure>3K/NoMesure> 
<NoMesure>39</NoMesure> 
<NoMesure>44</NoMesure> 
<NoMesure>48</MoMesure> 
<NoMesure>50</NoMesure> 
<NoMesure>53</NoMesure> 



</synopsisRecitant> 



On veutobtenir un document XM L qui donnele texte de la declamation, avec les nume- 
ros de mesure associes, comme ceci : 

synopsisRecitant.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 

<prologue> 
Le Tableau de TOperation de la Taille 
</prologue> 

<mesure No="l">L'aspect de 1 'apareil .</mesure> 

<mesure No="8">Fremissement en le voyant.</mesure> 

<mesure No="ll">Resolution pour y monter.</mesure> 

<mesure No="15">Parvenu jusqu'au haul t;</mesure> 

<mesure No="20">descente dudit apareil .</mesure> 

<mesure No="22">Reflexions serieuses.</mesure> 

<mesure No="23">Entrelassement des soyes 
Entre les bras et les jambes.</mesure> 

<mesure No="27">Icy se fait 1 ' incision. </mesure> 

<mesure No="31">Introduction de la tenette.</mesure> 

<mesure No="39">Ici Ton tire la piere.</mesure> 

<mesure No="44">Icy 1'on perd quasi la voix.</mesure> 

<mesure No="48">Ecoulement du sang.</mesure> 

<mesure No="50">Icy 1'on oste les soyes. </mesure> 

<mesure No="53">Icy 1'on vous transporte dans le lit.</mesure> 
'recitant> 
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On va done commeprevu utiliser la technique del 'element source litteral acontenu cal- 
cule. II estici parti culierement simple, etant la structure extremement plate du document 
aproduire: 

Element source litteral a contenu calcule 



II n'y a que deux valeurscalculees a placer dans I 'element source litteral : lenumero de 
mesure, et le texte a declamer. 

L a feuille de style devant manipuler deux sources X M L , on va done proceder de la meme 
faconquedansl'exemplevualasectionExemple, page 223, ou il s'agissaitdefairedela 
traduction d'apres un dictionnaire : 



<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Trc 



<xsl:output method='xml ' indent="yes" 
<xsl:param name="declamationFileRef" si 
<xsl variable name="declamation" 

select="document( $declat 



eRef ) /texte" /> 



<xsl :template match="/"> 

<recitant> 

<xsl :apply-templates/> 

</recitant> 
</xsl :template> 

<xsl :template match="prologue"> 

<prologue> 

<xsl :value-of select="$declamation/titre"/> 

</prologue> 
</xsl :template> 

<xsl :template match="Numeros"> 

</xsl :template> 



La source principale est le fichier synopsisRedtant.xmi, et la source secondaire le 
ficher deciamationTaiiie.xmi. Cechoix estbien sflr arbitral re, maiscomme la structure 
du document a produire est tres prochedela structure du document donnant le synopsis 
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du recitant, il estevidemment pi us facile de parti rdu fichier synopsisRecitant.xmi que 

dU richer declamationTai lie. xml. 

Letextede la declamation sera done accessibleautraversde la variable declamation, qui 
en I'occurrence est un node-set de trois elements, les trois elements rattaches a la racine 

<texte> dU document XML, aSaVOir : <reference>, <t1tre>, et<paroles>. 

Lenceuddu probleme, ici, est devoir comment remplirl'element source litteral : 



Comme il y a plusieurs numeros de mesure a traiter, tous sur le meme modele, nous 
aurons done une instruction <xsi :for-each> : 

<xsl : tempi ate match="Numeros"> 

<xsl:for-each select="NoMesure"> 



</xsl :template> 

Le texte qui doit apparaitre en (2) est a determiner en fonction de la position du 
<NoMesure> courant a I'interieur de I'instruction <xsi :for-each> : si par exemple 
I 'element <NoMesure> en cours est le quatrieme fils de I 'element <Numeros>, dans 
I'ordrede lecture du document, alorsil fautaller chercher le quatrieme fils del 'element 
<paroies> dans le document contenant la declamation. Cela n'estpasdu toutcomplique 
a faire: il suffit de sauvegarder dans une variable la position courante (e'est-a-dire la 
valeur4, dans notre exemple), et d'utiliser cette valeur dans un predicat: 

<xsl : tempi ate match="Numeros"> 

<xsl :for-each select="NoMesure"> 

<xsl :variable name="i" select="position( )" /> 
<mesure No=". . .(1). . ."> 

<xsl : val ue-of sel ect= " $decl ama ti on/pa roles/p[positi on ( )=$i ]"/> 
</mesure> 
</xsl:for-each> 
</xsl :template> 

n selectionne tous les elements <p> enfants de <paroi es>, et on filtre en ne retenant que 
celui dont la position est precisement egale a $1 . 

II n'y aplusqu'arenseigner la valeur del'attri but (marquee « ...(1)... » ci-dessus). Mais 
avant de voir comment faire cela, il n'est pas ininteressant de tenter la petite experience 
suivante : on va placer en (1) une expression XPathquelconque, n'importe laquelle, juste 
pour voir ce que le processeur X SLT va en faire. 
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;s/p[position() = $i]"/> 



Message d'erreur ? Evaluation ? Superbe indifference? Suspens... 

On choisit I'expression que I'on vient d'analyser; c'est bien siir completement idiot, 

mais voyons tout de meme : 

<xsl :template match="Numeros"> 

<xsl :for-each select="NoMesure"> 

<xsl :variable name="i" select="position( )" /> 
<mesure No="$declamation/paroles/p[position( ) = $i]"> 

<xsl :value-of select="$declamatic 
</mesure> 
</xsl:for-each> 
</xsl :template> 

On lance le processeur X SLT, et void ce qu'on obtient : 

interventionRecitant.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prologue> 
Le Tableau de 1'Operation de la Taille 
</prologue> 
<mesure No="$declamati on/pa roles/p[positi or 

</mesure> 
<mesure No="$declamation/paroles/p[positior 

<mesure No="$declamati on/pa roles/p[positi or 

</mesure> 
<mesure No="$declamation/paroles/p[positior 

</mesure> 
<mesure No="$declamati on/pa roles/p[positi or 

</mesure> 
<mesure No="$declamation/paroles/p[positior 

<mesure No="$declamati on/pa roles/p[positi or 

Entre les bras et les jambes.</mesure> 

<mesure No="$declamation/paroles/p[positior 

<mesure No="$declamati on/pa roles/p[positi or 

</mesure> 
<mesure No="$declamation/paroles/p[positior 



</mt 



ure> 



<mesure No="$declamati on/pa roles/p[positi or 

</mesure> 
<mesure No="$declamation/paroles/p[positior 
<mesure No="$declamati on/pa roles/p[positi or 



' = $i]">L'aspect de 1 'apareil . 

■ $i]">Fremissement en le voyant. 

: $i ]">Resol ution pour y monter. 

■■ $i]">Parvenu jusqu'au hault; 

i = $i ]">descente dudit apareil. 

■■ $i]">Reflexions serieuses. 

: $i ]">Entrelassement des soyes 

■■ $i]">Icy se fait 1 ■incision. 

' = $i ]">Introduction de la tenette. 

= $i]">Ici Ton tire la piere. 

= $i]">Icy I'on perd quasi la voix. 

= $i]">Ecoulement du sang.</mesure> 

= $i]">Icy I'on oste les soyes. 



</mc 



ure> 



<mesure No="$declamation/parc 
dans le 1 it.</mesure> 
</recitant> 



?s/p[positior 
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Le resultat est assez eloquent. Pas de message d'erreur, pas devaluation : la valeur 
d'attribut est prise pour du texte ordinaire, restituetel quel dans le document resultat. 

Cela ruine completement I 'espoir qu'on avait de produire les bons numeros de mesure, 
puisqu'apparemment, quelqu'expression que I'on puisse ecrire, die sera prise pour du 
textearecopier. 

Completement ? Pas tout a fait ; le cas a ete prevu. 

La solution estd'utiliser ici ce qu'on appelleun descripteur de valeur differ ee d'attribut, 
ou Attribute Value Template (denomination du standard XSLT). Le mot template, ici, 
n'estpaslebienvenu ; il estdejasurabondamment utilise en XSLT, etdans I e cas present, 
son utilisation nes'imposaitvraimentpas, car un attribute value template n'a rien avoir 
avec une regie (template rule) ni un modele de transformation (template, suivant la 
denomination standard XSLT). 

Descripteur de valeur differee d'attribut (Attribute Value Template) 

Un descripteur de valeur differee d'attribut, ce n'est pas une valeur d'attribut, mais c'est 
quelque chose qui de'crit une valeur d'attribut. La valeur n'est done pas fournie directe- 
ment et litteral ement, die est seulement decrite et par consequent differee : il faut en effet 
attendre I 'execution du processeur XSLT, qui va interpreter cette description, pour en 
tirer une valeur exploitable. 

Notez qu'il n'y a rien d'extraordinaire dans tout cela ; achaquefoisqu'on fournit I 'attri- 
but select d'une instruction xsi :vaiue-of, commeparexemple: 

select="$declamation/paroles/p[position( ) = $i]" 

on est dans la meme situation : la valeur de I'attribut n'est pas fournie I itteral ement, mais 
sous forme d'un descripteur, qui est ici une expression X Path. Cette expression decrit une 
valeur differee, puisqu'il faut attendre I 'execution du processeur XSLT pour que deva- 
luation ait lieu. 

Mors dans ces conditions, pourquoi inventer une denomination speciale si la chose est 
dej a connue, nominee, et courante ? 

Eh bien, pour la raison qu'on vient devoir. Si I'on emploie une expression X Path comme 
valeur d'attribut select, c'est parfait, puisque justement, on est cense fourni rune expres- 
sion XPath pour un attri but select. Parcontre, ce n'est pas parfait du tout pour un attri- 
but inconnu intervenant inopinement dans un element inconnu du processeur XSLT, 
comme peuvent I 'etre I 'element <mesure> et I'attribut No. Le processeur n'ayantaucune 
connaissancesurles<mesure>, les No, ni toutes ces sortes de choses, il nepeutpassavoir 
si la valeur d'attribut qu'on fournit est une valeur litterale, ou une valeur a interpreter. 

II faut done le lui dire. Si on ne dit rien de special, la valeur fournie est litterale; si on 
agite le chiffon rouge, le processeur est prevenu que la valeur fournie n'est pas litterale, 
mais que c'est une expression X Path a evaluer. 
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Le chiffon rouge en question, c'est une paired'accolades : {abed} est un descripteur de 
valeur differee d'attribut, indiquant que la chaine de caracteres « abed » est une expres- 
sion X Path a interpreter comme telle. Commed'habitudeen pareil cas, il fauttrouverune 
astuce pour pouvoir eventuellement fournir une valeur litterale, qui malheureusement, 
serai tde la forme {abed} ; pour annuler I'effet « chiffon rouge »deces accolades, on les 
redouble, comme ceci : {{abed}}. 

U n descripteur de valeur differee d'attribut est done evalue en tant qu'expression X Path, 
et le resultat obtenu estconverti en String, comme si lafonction standard stringo etait 
explicitementappelee. 

Remarque 

II ne suffit pas de demander pour etre servi : les endroits oil le langage XSLT autorise I'emploi de descripteur de 
valeur differee d'attribut sont assez peu nombreux (et meme plutot rares) dans I'ensemble. lis sont repertories 
en annexe (voir R egles syntaxiques, page 625). 

Notez qu'un descripteur de valeur differee d'attribut ne constitue pas necessairement la 
totalite de la valeur d'attribut: on peut tres bien ecrire une expression du genre 
"xy{abcd}zt" ; a I 'execution, la valeur d'attribut sera egale a la chaine litterale xy, suivie 
d'une String resultat del 'evaluation del 'expression X Path abed, suivie de la chaine litte- 
rale zt. 

Suite de I'exemple 

II ne nous reste plus qu'a utiliser cette notion de descripteur de valeur differee d'attribut 
pour terminer I'exemple que nous avions commence ci-dessus. 
N ous etions arrives a ce point : 



<xsl template match="Numeros"> 




<xsl :for-each select="NoMesure"> 




<xsl :variable name="i" select="positi 


onO" /> 


<mesure No=" . . . (1) . . . "> 




<xsl :value-of select="$declamatic 


n/paroles/p[positi 


</mesure> 




</xsl:for-each> 




</xsl :templ ate> 





Le probleme est maintenant de renseigner la valeur de I'attribut No. Au point (1), I'ele- 
ment courant est un certain <NoMesure>. La valeur a placer dans I'attribut No est done la 
valeur textuelle de I'element <NoMesure> courant. L expression XPath qui designe le 
noeud courant sereduisantsimplement a « . », le descripteur de valeur differee d'attribut 
a utiliser sera done simplement "{.}". On arrive done a cette version du programme: 

fusion.xsl 
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xmlns:xsl -"http://www.w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:output method='xml' indent="yes" encoding=' ISO-8859-1 ' /> 
<xsl:param name="declamationFileRef " select=" 'declamationTaine.xml ' " /> 
<xsl variable name="decl amation" 

select="document( SdeclamationFileRef )/texte" /> 

<xsl : tempi ate match="/"> 

<recitant> 

<xsl :apply-templates/> 

</recitant> 
</xsl :template> 

<xsl :template match="prologue"> 

<prologue> 

<xsl :value-of select="$declamation/titre"/> 

</prologue> 
</xsl :template> 

<xsl :template match="Numeros"> 
<xsl :for-each select="NoMesure"> 

<xsl : variable name="i" select="position( )" /> 
<mesure No="{.}"> 

<xsl:value-of select="$decl amation/paroles/p[position( ) = $i]"/> 
</mesure> 
</xsl:for-each> 
</xsl :template> 

<xsl template match="text( )"/> 
</xsl:stylesheet> 

Et le resultat obtenu estbien celui qu'on attendait : 

inter vent ionReci tant .xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 

<prologue> 
Le Tableau de TOperation de la Taille 
</prologue> 

<mesure No="l">L'aspect de 1 'apareil .</mesure> 

<mesure No="8">Fremissement en le voyant.</mesure> 

<mesure No="ll">Resol ution pour y monter.</mesure> 

<mesure No="15">Parvenu jusqu'au haul t;</mesure> 

<mesure No="20">descente dudit apareil .</mesure> 

<mesure No="22">Reflexions serieuses.</mesure> 

<mesure No="23">Entrelassement des soyes 

Entre les bras et les jambes.</mesure> 

<mesure No="27">Icy se fait 1 ' incision. </mesure> 

<mesure No="31">Introduction de la tenette.</mesure> 

<mesure No="39">Ici 1'on tire la piere.</mesure> 
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e No="44">Icy Ton perd quasi la voix.</mesure> 

e No="48">Ecoulement du sang.</mesure> 

e No="50">Icy l'on oste les soyes.</mesure> 

e No="53">Icy l'on vous transporte dans le 1 it.</mesure> 



Conclusion 

Avec les notions d'element source litteral a contenu calcule et de descripteur de valeur 
differee d'attribut, on a deja une certaine souplesse pour creer des documents XML; 
mais, ainsi que nous I'avons vu plus haut, certaines possibilites restent hors d'atteinte. 
Pour all er plus loin, il faut pouvoir creer de nouveaux elements (ou de nouveaux attri- 
buts) dontlenom estobtenu commeleresultat del 'evaluation d' une expression X Path. 

C 'est ce que nous al I ons voi r mai ntenant. 

Instruction xshelement 

Bande-annonce 

Cette instruction permet de creer des elements XML dans le document resultat. U n frag- 
ment de programme commecelui-ci : 



<Ensemble> 






<Nom> 






<xsl:val 


ue-of select= 


'NomEnsembl 


</Nom> 






<Di rection> 






<xsl:val 


ue-of select= 


'Chef"/> 


</Direction> 






</Ensemble> 






peutetreremplace 


par ceci : 




<xsl :element nan 


e="Ensemble"> 




<xs1: element 


name="Nom"> 




<xsl:val 


ue-of select= 


'NomEnsembl 


</xsl:elemer 


t> 




<xsl:element 


name="Di rect 


'on"> 


<xsl:val 


ue-of select= 


'Chef"/> 



L'avantage est que I'attribut name accepte les descripteurs de valeurs differees d'attribut, 
cequi permet decalculer lenom del 'element, au lieu qu'il faille lecabler en durdans le 
programme : 

<xsl :element name="{$x}"> 



</xsl :element> 
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Syntaxe 



instruction xsi:eiement ne doit pas apparaitre en tant qu'instruction de premier 
niveau. 



Semantique 



instruction <xs1: element name="xxx"> ... </xsl :el ement> produit dans le docu- 
ment resultat un element X M L de la forme <xxx> ... </xxx>, dontlenom estfourni par 
I'attributname, et dont le contenu est le resultat del'instanciation du modelede transfor- 
mation associe. 

Exemple trivial 

Le premier exemple sera une simple mise en parallele de la creation d'un document 
XML par la technique del 'element source litteral a contenu calcule, et par cellede ins- 
truction xsl : element. 

Pour cela, nous reprenons I 'exemple vu a la section Utilisation d'un TST calcule (XSLT 
1.1 ou plus), page 203. Nousavions mis au point ce programme XSLT (la presentation 
est legerement modifiee pour faciliter la comparaison) : 

preparelnsert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' encoding=' ISO-8859-1 ' indent='yes' /> 

<xsl : tempi ate match="/"> 

<Mouvements> 

<xsl :apply-templates/> 

</Mouvements> 
</xsl :templ ate> 

<xsl :template match="Concert"> 



<Ensemble> 
<Nom> 

<xsl:< 



2lect="NomEnsemble"/> 
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</Nom> 

<Di recti on> 

<xsl:value-of select="Chef'7> 

</Direction> 
</Ensemble> 
<Concert> 

<Date> 



</Date> 
<Ville> 



le-of select="Date"/> 



5-of select="Ville"/> 



<xsl:value-of select="Salle"/> 
</Lieu> 
<Titre> 

<xsl :value-of select="TitreConcert"/> 
</Titre> 
</Concert> 
</insert> 
</xsl:variable> 

<xsl :copy-of select="$mouvement"/> 
</xsl :template> 

<xsl :template match="text( )"/> 
</xsl: stylesheet) 

On a ici la creation d'un document XML cable dans le programme X SLT sous la forme 
d'un element source litteral a contenu calcule. On va done voir comment faire la meme 

Chose avec I'inStrUCtion xsl :element. 

La modification est assez triviale: dans la regie <xsi: tempi ate match="Concert n > il 
suffit de remplacer chaque balise litterale (hors du domaine nominal d'XSLT) par une 
instruction xsi : ei ement, comme ceci : 

<xsl : tempi ate match="Concert"> 

<xsl :variable name="mouvement"> 
<xsl :element name="insert"> 

<xsl:element name="Ensemble"> 
<xsl :element name="Nom"> 

<xsl :value-of select="NomEnsemble"/> 
</xsl:element> 
<xsl : el ement name="Di recti on "> 

<xsl:value-of select="Chef'7> 
</xsl:element> 
</xsl :element> 

<xsl:element name="Concert"> 
<xsl:element name="Date"> 

<xsl :value-of select="Date"/> 
</xsl :element> 
<xsl:element name="Vil le"> 
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<xsl:value-of select="Vill 
</xsl :element> 
<xsl:element name="Lieu"> 

<xsl :value-of select="Sall 
</xsl :element> 
<xsl : element name="Titre"> 



<xsl :value-of select="TitreConcert"/> 
</xsl :element> 
</xsl:element> 
</xsl :element> 
</xsl:variable> 

<xsl :copy-of select="$mouvement"/> 
</xsl :template> 

Cette regie est I 'equivalent de cell emontree dans le programme ci-dessus, et bien sfir, a 
I 'execution, le resultat obtenu est strictementidenti que dans ledeux cas. 

Mais clairement, ici, instruction xsi :eiement n'apporte rien du tout, et rend meme le 
programme plus difficile a lire, en lui donnant une apparence plus confuse. 

Exemple plus evolue 

Nous allons ici revoir un exemple du meme genre que celui vu a la section Exemple, 
page 263 : un probleme de fusion de documents XML. Mais la difference avec le cas 
assez simple que nous avions vu, est que cette fois, lenom des elements a produi re dans 
le document resultat est calcule lors du processus de fusion ; la technique de I 'element 
source I itteral ne sera done pasutilisable. 

Le contexte est celui d'une application serveur, construite autour de technologies a 
objets, qui doit d'une part, presenter a un client leger (navigateur Web) emetteur de 
requetes, des donnees prelevees dans une base relationnelle et d'autre part, assurer la 
miseajour en temps reel de cette base, enfonction des requetes emises. L 'application est 
architecture autour d'un referentiel metier, e'est-a-dire un ensemble de classes modeli- 
sant les entites et les relations issues d'une analyse semantique du metier sous-jacent. 
L'un des problemes classiques a resoudre est ce qu'on appelle le « mapping », dans le 
jargon consacre, c'est-a-direla miseen correspondance d'une classeet d'une table, dans 
lecas le plus simple (les cas plus complexes sontceux ou les attributs d'un objet corres- 
pondent a des colonnes reparties dans plusieurs table). Cette mise en correspondance 
consistetoutsimplementarecuperer les bonnes colonnes dans la bonne table pour char- 
ger un objet, ou inversement, de mettre a jour les bonnes colonnes de la bonne table a 
partir des attributs d'un objet. 

II y a plusieurs f aeons de realiser les mappings necessaires a I 'application ; I'uned'entre 
el les, qui n'est pas la moins mauvaise, consiste a ecrire un generateur de code capable de 
produi re automatiquement les classes (en Java, par exemple) qui vont realiser I 'interface 
entre les objets metier et la base de donnees. U n tel generateur de code va s'appuyer sur 
un fichierde mapping, qui pourrait avoir I 'allure suivante: 



Les instructions de creation 



mapping .xml 

<?xml version="1.0" encoding="IS0-885? 
<mapping> 

<table>ACCORD</table> 
<ACC0RD> 

<DEDEC> 

<field>beginning_date</field) 
<type>BusinessDate</type> 

</DEDEC> 

<CCETF> 

<field>state</field> 
<type>String</type> 

</CCETF> 

<N0ACA> 

<field>company_id</field> 
<type>String</type> 

</N0ACA> 

<N0POA> 

<field>contract_nbr</field> 
<type>String</type> 

</N0P0A> 

<CCPAA1> 

<f i el d>country_code</f i el d> 
<type>Integer</type> 

</CCPAAl> 
</ACC0RD> 

<table>COMPANY</table> 
<C0MPANY> 

<N0ACA> 

<field>company_id</field> 
<type>String</type> 

</N0ACA> 

<LSACA1> 

<field>company_name</field> 
<type>String</type> 

</LSACAl> 

<CCPAA1> 

<field>country_code</field> 
<type>Integer</type> 

</CCPAAl> 

<LAACA1> 

<field>address</field> 
<type>String</type> 

</LAACAl> 

<URL> 

<field>URL</field> 
<type>String</type> 

</URL> 

<STATRAT> 

<field>quality_code</field> 
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<type>String</type> 
</STATRAT> 
</C0MPANY> 
</mapping> 

dedec, ccetf, noaca, etc. represented des noms de colonnes qui sont mis en correspon- 
dence avec des noms d'attributs (<fi ei d>) et des types J ava (<ty P e>). 

Ce genre de fichier, pour une petite application, pourrait etre constitue a la main ; mais 
pour une application qui doit se connecter a une base existante comportant une centaine 
de tables de dix a soixante colonnes dont les noms sont pour la plupart i mprononcables et 
difficilesamemoriser, il est clairqu'un travail a la main n'estpasadequat. 

L'administrateur de la base de donnees, mis a contribution, nous a fourni un fichier par 
table, ayant la structure suivante : 

accord.xml 



<?xml version="1.0" encoding="UTF-16"?> 

<table name="ACCORD"> 

DEDEC<tab/>DATE<br/> 

CCETF<tab/>CHAR(l)<br/> 

N0ACA<tab/>CHAR(6Xbr/> 

N0P0A<tab/>VARCHAR2(35Xbr/> 

CCPAAKtab/>NUMBER(4Xbr/> 

</table> 

company .xml 

<?xml version="1.0" encoding="UTF-16" ?> 

<table name="COMPANY"> 

N0ACA<tab/>CHAR(6Xbr/> 

LSACAKtab/>VARCHAR2(35Xbr/> 

CCPAAKtab/>NUMBER(4Xbr/> 

LAACAKtab/>VARCHAR2(35Xbr/> 

URL<tab/>VARCHAR2(40Xbr/> 

STATRAT<tab/>VARCHAR2( 1 )<br/> 

</table> 

La structure decesfichiersn'est pas extraordinaire, mais ilscontiennent les informations 
dont on a besoin (lenom des colonnes etle type SQL utilise) ; il faudra done fai re avec. 
M ais bien sflr, ce que ces fichiers ne donnent pas, e'est la correspondance des noms de 
colonnes et des noms d'attributs. Ce fichier de correspondance ne peut pas etre genere, 
il faut le constituer a la main ; maisc'estmoinspeniblequed'etablirala main le fichier 
de mapping, car les memes noms de colonnes reviennent assez souvent dans des tables 
differentes. 

fields .xml 



<?xml ver 


sion= 


"1.0" e 


ncoding="UTF-16"?> 


<fields> 








<fiel 


i id= 


"DEDEC" 


>beginning date</fiel 


<fiel 


i 1d= 


"CCETF" 


>state </fiel 
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<field 


d="N0ACA" 


>company_id 


</fi 


<field 


d="N0P0A" 


>contract_nbr 


</fi 


<f1eld 


d="CCPAAl' 


>country_code 


</fi 


<field 


d="LSACAl' 


>company_name 


</fi 


<field 


d="LAACAl' 


>address 


</fi 


<field 


d="URL" 


>URL 


</fi 


<field 


d="STATRAT 


">qual ity_code 


</fi 


</fields> 









Leprobleme est done maintenantpose : en partant des fichiers accord, xmi, company, xmi 
et fields. xmi, il s'agit de produire le fichier mapping. xmi . 

Mais, commenousl'avonsdit, il peuty avoir pi usieursdizainesde tables; oril neserait 
pas raisonnable d'avoir plusieurs dizaines de sources XML pour le programme XSLT. 
N ous al I ons done commencer par reunirtoutes les sources dedescripti on de tables en une 
seule, en utilisant des appels d'entites XML externes, comme ceci : 

tables .xmi 

<?xml version="1.0" encoding="UTF-16" ?> 

<!D0CTYPE tables [ 

<!ENTITY accord SYSTEM 'accord. xmi '> 

<! ENTITY company SYSTEM 'company .xmi '> 

]> 

<tables> 

&accord; 

&company; 

</tables> 

LefichierXML tables, xmi est equivalent a un fichier unique: 

<?xml version="1.0" encoding="UTF-16" ?> 



<table name="ACCORD"> 

DEDEC<tab/>DATE<br/> 

CCETF<tab/>CHAR(l)<br/> 

N0ACA<tab/>CHAR(6Xbr/> 

N0P0A<tab/>VARCHAR2(35Xbr/> 

CCPAAKtab/>NUMBER(4Xbr/> 

</table> 

<table name="COMPANY"> 

N0ACA<tab/>CHAR(6Xbr/> 

LSACAKtab/>VARCHAR2(35Xbr/> 

CCPAAKtab/>NUMBER(4Xbr/> 

LAACAKtab/>VARCHAR2(35Xbr/> 

URL<tab/>VARCHAR2(40Xbr/> 

STATRAT<tab/>VARCHAR2 ( 1 )<br/> 

</table> 
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Nous al Ions maintenantprocederen deux etapes. 

Premiere etape 

La premiere etape consiste a trouver comment recuperer les informations pertinentes 
dans le fichier XML tables. xmi , dont la structure est bizarre, calqueesur une structure 
de fichier d'export de schema de base, mais pas du tout dans le style X M L . 

Le probleme est done de savoir comment, a partir du fichier tables. xmi, on pourrait 
obtenir le fichier suivant: 

table ACCORD : 

nom de colonne = DEDEC; type = DATE 
nom de colonne = CCETF; type = CHAR(l) 
nom de colonne = NOACA; type = CHAR(6) 
nom de colonne = NOPOA; type = VARCHAR2(35) 
11 de colonne = CCPAA1; type = NUMBER(4) 

Die COMPANY : 

11 de colonne = NOACA; type = CHAR(6) 

n de colonne = LSACA1; type = VARCHAR2(35) 

n de colonne = CCPAA1; type = NUMBERC4) 

n de colonne = LAACA1; type = VARCHAR2(35) 

n de colonne = URL; type = VARCHAR2H0) 

n de colonne = STATRAT; type = VARCHAR2(1) 

Pour chaque table, il y a une succession d'elements <tab/> ; et pour chaque element 
<tab/>, lenom de colonne est I e premier nceud de type text, situe juste avant I 'element 
<tab/> courant (e'est lenoeud en premiere position sur I'axe preceding-sibling), et le 
nom de type SQL est le premier nceud detype text, situe juste apres I'element <tab/> 
courant (e'est le nceud en premiere position sur I 'axe f oi i owi ng-si bi 1 ng). 

Le programme X SLT qui produit le document resultat montre ci-dessus decoule directe- 
ment de cette remarque : 

essai .xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 



<xsl:output method='xml' indent="yes" encodings' ISO-8859-1 ' I) 

<xsl :template match="table"> 

<xsl :text/>table <xsl : value-of select="@name"/> :<xsl:text) 
</xsl:text> 

<xsl :for-each select="tab"> 

<xsl:text>nom de colonne = </xsl:text> 
<xsl :value-of select="normal ize-space( 

preceding-sibling: :text( )[1] )"/> 
<xsl:text>; type = </xsl:text> 
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<xsl:va1ue-of select="normalize-space( 

following-sibling::text()[l])"/> 
<xsl:text> 
</xsl:text> 

</xsl :for-each> 

</xsl :template> 

<xsl :template match="text( )"/> 
</xsl:stylesheet> 

Deuxieme etape 

II s'agit maintenant de faire la synthese entre la premiere source XML, representee par 
lefichier tables. xmi, et la deuxieme, qui donne la correspondance entre les nomsdeco- 
lonnes et les noms d'attributs. Ce probleme ressemble fortement au probleme de traduc- 
tion que nous avions vu a la section Exemple, page 223. Nous pourrons done reprendre 
les elements realisant une traduction, que nous avions mis au point a cette occasion, et 
les adapter a notre probleme actuel. 

II y aaussi unecertaineressemblanceavec ce que nous avonsvu a la section precedente 
(voir Exemple trivial, page 273), puisqu'il vaetre question decreer des elements dans I e 
document resultat. M ais la ressemblance n'est pas complete, car ici nous allons devoir 
creer des elements (comme <noaca> ) dont le nom ne peut pas etre mis « en dur » dans le 
programme. 

instruction qui fait cela esttoujours I 'instruction <xsi :eiement>, eta supposer que le 
nom de I'element a generer soit contenu dans une variable ei ementName, la premiere idee 
qui pourraitvenir a I 'esprit seraitd'ecri re quelque chose comme: 

<xsl :element name="$elementName"> 

Mais on tombesur le probleme deja analyse a la section Descripteur de valeur differ e'e 
d'attri but (Attribute Value Template), page 269 : a I 'execution, soit on vaobtenirceci : 

<$elementName> 

|<field>...</field> 
<type>. . .</type> 
</$elementName> 

alorsqu'on attend : 

<DEDEC> 

i<field>...</field> 
<type>. . .</type> 
</DEDEC> 

soiton vaobtenirun message d'erreurdu processeurXSLT, degoute d'avoir failli mordre 
dans une baliseXM L pleined'asticots(<$eiementName>), a en juger parcelui qui setor- 
tilleau debut. 
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La solution est la meme que precedemment, il faututiliserun descripteur de valeur diffe- 
ree d'attribut. 



Attention 

II se trouve que nous sommes dans un cas, avec I'instruction <xsl : el ement>, ou un descripteur de valeur diffe- 
red d'attribut est autorise pour I'attribut name. Mais nous avons deja signale que ce n'etaitpas une construction 
toujours possible. 

Les descripteurs de valeurdifferee d'attribut sont, il estvrai, toujours autorises etreconnus avec un elementXML 
faisantpartie d'un elementsource litteral, mais c'esttoutle contraire avec les attributs des elements XSLT (c'est- 
a-dire des instructions XSLT) : ils sonttres rarementacceptes ou reconnus. 

Mais I'instruction <xsi :eiement>faitpartiedesheureuseselues, etcatombebien, parce 
quesinon, il n'y avait plusqu'a mettrela de sous la porte: cequ'on voulaitfaireaurait 
ete impossible. 

Note 

Tiens, tiens ? Le langage XSLT n'auraitdonc plus eteTuring-completacause de ce detail stupide ? II y auraiteu 
des choses impossibles a programmer? Non, rassurez vous, cela n'aurait rien change au caractere Turing- 
complet du langage. En fait on peut se passer de descripteur de valeur differee d'attribut : il suffit de ne pas 
vouloir generer du texte XML, mais du texte ordinaire, quitte a sortir « a la main » tous les caracteres speciaux 
comme « <»ou « >», Mais cela seraitdebeaucoup plus bas niveau, beaucoup plus complique a lire, etpropice 
auxerreurs.En effetunTST ne peut pas etre mal structure ;c'estnecessairementun arbre avec une vraie forme 
de vrai arbre, pas un eclope genetiquement modifie : si on bricole soi meme les boutures en contournant les 
regies lexicalesdeXML, on peutfaire beaucoup d'erreurs sans etre jamais avertiparle parseurXML associeau 
processeurXSLT. 

Toujours est-il qu'en ecrivant : 

<xsl :element name="{$elementName}"> 

au lieu de: 

<xsl :element name="$elementName"> 

on a la solution. 

Rappelons que I'on veutobtenirquelque chose qui commence ainsi : 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mapping> 

<table>ACCORD</table> 
<ACC0RD> 
<DEDEC> 

<field>beginning_date</field> 
<type>BusinessDate</type> 
</DEDEC> 
<CCETF> 

<field>state</field> 
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<type>String</type> 
</CCETF> 
<N0ACA> 

<field>company_id</field> 

<type>String</type> 
</N0ACA> 

Un element comme <dedec> sera genere en allant chercher le texte situe juste avant le 
<tab/> courant dans le fichier tabi es . xmi (voir P remi<?re <?tape, page 279), en recuperant 
ce texte dans une variable eiementName, et en utilisant cette variable comme montre ci- 
dessus, dans une instruction xsi :eiement. 

Un element comme <fieid>beginning_date</f-ieid> sera genere en allant chercher la 
traduction du texte contenu dans $eiementName, obtenue par un dictionnaire (le fichier 
fields. xmi vu ci-dessus). Nous emploierons la meme technique que celle vue a la sec- 
tion Exemple, page 223, avec le dictionnaire lu en tant que source externe par la fonction 

document( ). 

Enfin, un element comme <type>string</type> sera genere en allant chercher le texte 
situe juste apres I 'element <tab/> courant, et en testant s'il contient la chaine char ou 

VARCHAR. 

On aboutit done au canevas suivant : 

sl:for-each select="tab"> 
<!-- ici : eiementName = le texte situe juste avant le <tab> courant --> 
<xsl :element name="{$elementName}"> 
<field> 



</field> 

<type> 

<!-- ici: typeSQL = le texte situe juste apres le <tab> courant - 

<xsl :choose> 

<xsl:when test="contains( StypeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 

<xsl:when test="contains( StypeSQL, 'DATE' )" > 
<xsl :text>BusinessDate</xsl :text> 
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<xsl:when test="contains( StypeSQL, 'NUMBER' 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl :choose> 



</type> 
</xsl :element> 



Le programme de fusion-synthese des documents tables. xmi et fields. xmi est done 
celui-ci : 

mapping. xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl: stylesheet 

xmi ns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 

<xsl :param name="dicoFileRef ">fields.xml</xsl :param> 

<xsl :variable name="Dictionnaire" select="document($dicoFileRef )/fields"/> 

<xsl :template match="/"> 

<mapping> 

<xsl :apply-templates/> 
</mapping> 
</xsl :template> 



<xsl :template name="traduction"> 
<xsl:param name="motId"/> 

<xsl variable 

name="saTraduction" 
select="$Dictionnaire/field[@id=$motId]" /> 

<xsl :value-of select="normalize-space($saTraduction)" 
</xsl :template> 



<xsl :value-of select="@nan 
</table> 



cslrelement name="{@name}"> 
<xsl:for-each select="tab"> 
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ame="elementName" 
;lect="normalize-space( 

preceding- sibling: :text()[l] 



;nt r 



= "{$ele 



;ntNan 



<field> 

<xsl :cal 1 -template r 
<xsl :with-param r 
</xsl :cal 1 -tempi ate> 
</field> 
<type> 

<xsl :variable name="typeSQL" select="normal ize-space( 

following-sibling: :text()[l] 
)"/> 
<xsl :choose> 

<xsl:when test="contains( StypeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 

<xsl:when test="contains( StypeSQL, 'DATE' )" > 

<xsl :text>BusinessDate</xsl :text> 
</xsl :when> 

<xsl:when test="contains( StypeSQL, 'NUMBER' )" > 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl:choose> 
</type> 
/xsl:element> 



<xsl :template match="text( )"/> 
</xsl:stylesheet> 

On obtientcommeresultatlefichier mapping.) 
pluse'volue, page 275. 



ni montreau debut de la section Exemple 



Variante syntaxique namespace="..." 

Onpeutsi I 'on veutaj outer un attri but namespace, commececi : 
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<!-- fin du modele de transformation --> 
</xsl :element> 

L'attri but namespace (une chaine de caracteres) permetd'affecter un domaine nominal a 
I'elementqui vaetrecree. Un descripteur de valeur differee d'attribut est accepte ici. La 
chaine de caracteres qui constitue le domaine nominal n'est pas analysee par le proces- 
ses XSLT, doncaucun control e de validite de cette chaine n'est effectue. 

Notonsd'embleequela manierela plus simple d'affecter un domaine nominal aux ele- 
mentsXML creesparun programme XSLT n'est pas d'utiliser I'instruction xsi element 

aveC I'attribut namespace . 

Exemple sans namespace="..." 

N ous reprenons ici I 'exemple vu a la section Suite de I 'exemple, page 270, et nous suppo- 
sons que le domaine nominal des elements a generer doit etre "http://concerts.ana- 
creon.org/vioie-de-gambe", et que ce domaine nominal est un domaine par defaut. 
Dans ce cas, il n'a y presque rien a faire, si ce n'est de declarer le domaine nominal en 
question dans la racinedu programme: 



fusion.xsl 






<?xml ver. 


ion="1.0" encoding="UTF-16"?> 




<xsl:style 


sheet 




xmlns 


xsl="http: //www. w3.org/1999/XSL/Tr 


ansform" 


xmlns= 


"http://concerts.anacreon.fr/viole 


-de-gambe" 



<xsl:output method='xml' indent="yes" encodings' ISO-8859-1 ' /> 
<xsl:param name="declamationFileRef " select=" 'declamationTaille.xml ' " /> 
<xsl variable name="declamation" 

select="document( SdeclamationFileRef )/texte" /> 

<xsl : tempi ate match="/"> 

<recitant> 

<xsl :apply-templates/> 

</recitant> 
</xsl :template> 

<xsl :template match="prologue"> 

<prologue> 

<xsl:value-of select="$decl amation/titre"/> 

</prologue> 
</xsl :templ ate> 

<xsl :template match="Numeros"> 

<xsl :for-each select="NoMesure"> 

<xsl variable name="i" select="position( )" /> 
<mesure No="{.}"> 

<xsl : val ue-of select="$declamation/paroles/p[position( )=$i]"/> 
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</mesure> 
</xsl :for-each> 
</xsl :template> 

<xsl :template match=" 
</xsl:stylesheet> 



<?xml version="1.0" encoding="IS0-8859-l"?> 

<recitant xmlns=" http://concerts.anacreon.fr/viole-de-gambe"> 

<prologue> 
Le Tableau de 1 'Operation de la Taille 
</prologue> 

<mesure No="l">L'aspect de 1 'apareil .</mesure> 

<mesure No="8">Fremissement en le voyant.</mesure> 

<mesure No="ll">Resolution pour y monter.</mesure> 

<mesure No="15">Parvenu jusqu'au hault;</mesure> 

<mesure No="20">descente dudit apareil .</mesure> 

<mesure No="22">Reflexions serieuses.</mesure> 

<mesure No="23">Entrelassement des soyes 
Entre les bras et les jambes.</mesure> 

<mesure No="27">Icy se fait 1 'incision. </mesure> 

<mesure No="31">Introduction de la tenette.</mesure> 

<mesure No="39">Ici Ton tire la piere.</mesure> 

<mesure No="44">Icy l'on perd quasi la voix.</mesure> 

<mesure No="48">Ecoulement du sang.</mesure> 

<mesure No="50">Icy l'on oste les soyes. </mesure> 

<mesure No="53">Icy l'on vous transporte dans le 1 it.</mesure> 
</recitant> 

L'element<recitant> aeteequiped'un attri but xmi ns qui donne I edomaine nominal par 
defaut, et toute la descendance (enfants, petits-enfants, etc.) herite de ce domaine nomi- 
nal par defaut. Les elements <proiogue> et <mesure> sont done eux aussi dans le 

domaine nominal http://concerts.anacreon.fr/viole-de-gambe. 

Autre exemple sans namespace="..." 

Une autre possibi lite est de declarer un domaine nominal explicite pour chaque element 
cree. Celasefaittressimplementendonnantexplicitementleprefixe(ouabreviation) du 
domaine nominal a utiliser, a condition que ce domaine ait ete declare et soit visible a 
I'endroit ou I'abreviation est utilisee : 

fusion.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

xmlns:vdg=" http://concerts.anacreon.fr/viole-de-gambe" 

<xsl:output method='xml' indent="yes" encodings' ISO-8859-1 ' /> 
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<xsl:param name="declamationFileRef " si 
<xsl :variable name="declamation" 

select="document( Sdeclar 



lect="'declamationTail 



ationFileRef )/texte" /> 



<xsl : tempi ate match="/"> 

<vdg:recitant> 

<xsl :apply-templates/> 

</vdg:recitant> 
</xsl :template> 

<xsl : tempi ate match="prologue"> 

<vdg:prologue> 

<xsl:value-of select="$declamation/titr 

</vdg:prologue> 
</xsl :templ ate> 

<xsl :template match="Numeros"> 

<xsl :for-each select="NoMesure"> 

<xsl :variable name="i" select="positior 
<vdg:mesure No="{.}"> 

<xsl :val ue-of select="$declamation/ 
</vdg:mesure> 



5s/p[position()=$i]"/> 



</xsl:fc 

</xsl :template> 



;ach> 



<?xml version="1.0" encoding="IS0-8859-l"?> 
<vdg:recitant xmlns:vdg=" http://concerts.anac 
<vdg:prologue> 

Le Tableau de TOperation de la Taille 
</vdg:prologue> 



Zl 


mesure 
mesure 


<vdg 


mesure 


<vdg 


mesure 


<vdg 


mesure 


<vdg 


mesure 


<vdg 


mesure 


Entre 1 


<vdg 


mesure 


<vdg 


mesure 


<vdg 


mesure 


<vdg 


mesure 


<vdg 


mesure 


<vdg 


mesure 


<vdg 


mesure 


</vdg:r 


citant> 



No="l">L'aspect de 1'apa 
8">Fremissement en 1 
ll">Resolution pour 

No="15">Parvenu jusqu' 



eil.</vdg:mesu 
: voyant.</vdg: 

■ monter.</vdg: 
hault;</vdg:me 






20">descente dudit apareil .</vdg:mesure> 
No="22">Reflexions serieuses.</vdg:mesure> 
Entrelassement des soyes 
et les jambes.</vdg:mesure> 
No="27">Icy se fait 1 ' incision. </vdg:mesure> 

31">Introduction de la tenette.</vdg:mesure> 
No="39">Ici Ton tire la piere.</vdg:mesure> 
No="44">Icy 1'on perd quasi la voix.</vdg:mesure> 
No="48">Ecoulement du sang.</vdg:mesure> 
No="50">Icy 1'on oste les soyes. </vdg:mesure> 
No="53">Icy 1'on vous transporte dans le lit.</vdg:rr 
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Exempleavec namespace="..." 

Enfin, nous en arrivons a une solution ouon utilise effectivementl'attri but namespace de 

I 'instruction xsl : element : 

fusion.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 
<xsl:param name="declamationFileRef " select=" 'declamationTail le.xmT " /> 
<xsl variable name="declamation" 

select="document( SdeclamationFileRef )/texte" /> 

<xsl :template match="/"> 

<recitant> 

<xsl :apply-templates/> 

</recitant> 
</xsl :template> 

<xsl :template match="prologue"> 

<prologue> 

<xsl :value-of select="$declamation/titre"/> 

</prologue> 
</xsl :template> 

<xsl :template match="Numeros"> 

<xsl :for-each select="NoMesure"> 

<xsl variable name="i" select="position( )" /> 
<xsl:element name="mesure" 

names pace=" http://concerts.anacreon.fr/viole-de-gambe"> 
<xsl: attribute name="No"Xxsl :value-of select=".'7> 
</xsl :attribute> 

<xsl:value-of select="$declamation/paroles/p[position( )=$i]"/> 
</xsl:element> 
</xsl :for-each> 
</xsl :template> 

<xsl : tempi ate match="text()"/> 
</xsl: stylesheet) 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prologue> 
Le Tableau de 1'Operation de la Tail le 
</prologue> 
<mesure xmlns=" http://concerts.anacreon.fr/viole-de-gambe" No="l"> 
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L'aspect de l'apareil .</mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Fremissement en le voyant.</mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Resolution pour y monter.</mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Parvenu jusqu'au hault;</mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

descente dudit apareil .</mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Reflexions serieuses.</mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Entrelassement des soyes 
Entre les bras et les jambes.</mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Icy se fait 1 'incision. </mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Introduction de la tenette.</mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Ici l'on tire la piere.</mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Icy l'on perd quasi la voix.</mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Ecoulement du sang.</mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Icy l'on oste les soyes. </mesure> 
<mesure xmlns=" http://concerts.anacreon.fr/vio 

Icy l'on vous transporte dans le lit.</mesur< 
/recitant> 



!-de-gambe" No="8"> 

;-de-gambe" No="ll"> 

;-de-gambe" No="15"> 

;-de-gambe" No="20"> 

!-de-gambe" No="22"> 

;-de-gambe" No="23"> 

;-de-gambe" No="27"> 

;-de-gambe" No="31"> 

;-de-gambe" No="39"> 

!-de-gambe" No="44"> 

;-de-gambe" No="48"> 

;-de-gambe" No="50"> 

!-de-gambe" No="53"> 



Ici, il n'y a pas grand interet a proceder de la sorte, puisque I 'element <mesure> n'a pas 
d'element fils. Le domaine nominal par defaut est inutilement repete pour chaque 
<mesure>, alors qu'il aurait ete plus simple, comme on I'a vu plus haut, de declarer ce 
domaine nominal par defaut directement sur I 'element racine <r<§dtant>. 



Variante syntaxique use-attribute-sets=' 

Cet attri but va de pair avec I' instruction xsi : 
(voir Instruction xsl: attribute-set, page 304). 



;et, qui sera etudiee plus loin 
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2ncoding="UTF-16" standalone="yes"?> 
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<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Compositeur>M. Marais</Compositeur> 
<Compositeur>D. Castel lo</Compositeur> 
<Compositeur>F. Rognoni</Compositeur> 

</Compositeurs> 



</Concert> 
Concert.xsl 



cml version="1.0" encoding="UTF-16"?> 

;l:stylesheet xmlns :xsl="http://www. w3.org/1999/XSL/Transform" version="l.C 

<xsl:output method='xml' encoding=' ISO-8859-1 ' indent='yes' /> 

<xsl :template match="/"> 

<xsl :apply-templates/> 
</Interpretes> 
</xsl :template> 

<xsl :template match="Interprete"> 
<Interprete> 

<xsl attribute name="Nom"> 

<xsl :value-of select=" ./Nom"/> 
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</xsl: attribute) 

<xsl :attribute name="Instrument") 

<xsl :value-of select=" ./ Instrument" /> 
</xsl: attribute) 
</Interprete) 
</xsl :template> 

<xsl : tempi ate match="text()"/> 

</xsl: stylesheet) 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<Interpretes) 

<Interprete Nom=" Jonathan Dunford " Instrument="Basse de viole"/> 
<Interprete Nom=" Sylvia Abramowicz " Instrument="Basse de viole"/> 
<Interprete Nom=" Benjamin Perrot " Instrument="Theorbe et Guitare baroque"/) 

</Interpretes) 

Syntaxe 

L'instruction <xsi attribute) permet de creer un nouvel attribut, dontlenomestfourni 
par I'attribut name, et la valeur par le modele de transformation associe. E Me prend la 
forme suivante : 



<!-- modele de transformation propre a xsl attribute --) 

<!-- fin du modele de transformation propre a xsl attribute --> 
</xsl attribute) 

L'instruction xsi attribute ne doit pas apparaitre en tant qu' instruction de premier 
niveau. 

Regie XSLT ty pique 

Comme un attribut ne peut pas apparaitre isolementdans un document XML, instruc- 
tion <xsi attribute) est toujoursassocieed'unemaniereoud'uneautreauneinstruction 
de creation d'element. Les deux formes syntaxiques qui suivent sont couramment 
employees pour realiser cette association. 

L'instruction <xsi :attribute> peut s'uti I i ser en tant que complement pour l'instruction 
<xsi : element), qui prend alors la forme suivante : 

xsl : attribute 

<xsl:element name="..."> 

<xsl :attribute name=" . . . ") 
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<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 
<xsl attribute name="..."> 

<!-- modele de transformation propre a xsl attribute --> 

<!-- fin du modele de transformation propre a xsl attribute --> 
</xsl :attribute> 

... autres instructions <xsl :attribute> ... 
<!-- modele de transformation propre a xsl:element --> 

<!-- fin du modele de transformation propre a xsl:element --> 
</xsl :element> 

Les instructions <xsi :attrit>ute> doivent obligatoirement etre regroupees et constituer 
les premiers enfants directs de ^instruction <xsi :eiement> ; il est interdit de les diluer 
parmi I'ensembledes enfants existants. 

instruction <xsi :attn'bute> peut aussi etre utilisee pour fournir un attri but a un ele- 
mentXML faisant partie d'un element source litteral : 

xsl : attribute 

<xxx> 

<xsl :attribute name="..."> 

<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl:attribute> 
<xsl attribute name="..."> 

<!-- modele de transformation propre a xsl attribute --> 

<!-- fin du modele de transformation propre a xsl attribute --> 
</xsl :attribute> 

... autres instructions <xsl :attribute> ... 
<!-- modele de transformation propre a 1 'element xxx --> 

<!-- fin du modele de transformation propre a l'element xxx --> 

Les instructions <xsi :attribute> doivent obligatoirement etre regroupees et constituer 
les premiers enfants directs de l'element <xxx> ; il est interdit de les diluer parmi 
I'ensembledes enfants existants. 

Emploi moins typique 

Les deux formes syntaxiques que nous venons de voir pour realiser I'association entre 
attri but et element ne sont pas les deux seules possibles, ce sont seulement les plus cou- 
rantes. 
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En fait, ce qui compte, dans la realisation de cette association, ce n'est pas la proximite 
topologique et statique de deux instructions placees en regard I'une de I'autre dans le 
fichier source XSLT, maisla proximite temporel I eetdynami que : il faut que I 'instruction 
<xsi :attribute> soit instanciee juste apres une instruction <xsi :eiement> ou une autre 

instruction <xsl :attribute>. 

Les deux formes syntaxiques vues ci-dessus permettent de facon evidente d'obtenir ce 
resultat, maisil y en au moins une autre, consistant a instancier I' instruction <xsi:eie- 
ment> dans un modele nomme, et ['instruction <xsi :attribute> dans un autre modele 
nomme. Dans cecasde figure, les deux instructions <xsi :attribute> et<xsi :eiement> 
peuvent etre tres eloigners I'une de I'autre tout en etant dynamiquement associees. 
Etfinalement, il en reste encore une derniere : celle consistant a prendre I'une des deux 
formes typiques (voir Regie XSLT typique, page 291), et a intercaler des instructions 
quelconquesentre la premiere instruction xsi :attributeetl'elementdontelledepend, a 
condition que ces instructions ne creent rien dans le document resultat. N ous verrons cela 
dansun prochain exemple(voirExemple pluse'volue, page 295). 

Semantique 

U n nouvel attribut est cree, et attache a son element parent ; le nom de cet attribut est 
fourni par la valeur de I'attribut name, valeur qui peut, si I'on veut, etre fournie sous 
forme d'un descripteur de valeur differee d'attribut (AVT) : le nom de I'attribut n'est 
done pas forcement une chalne « en dur » dans le programme X SLT (e'est I'un des rares 
endroits, en XSLT, ouun descripteur de valeur differee d'attribut est autorise). Quant a sa 
valeur, e'est le fragment de document resultat de I'instanciation du modele de transfor- 
mation propre a I 'instruction xsi attribute en cours. Ce fragment de document resultat 
doit etre un texte ordinaire, sans aucun element XML (pas de balise X M L ). 

Dans ce processus de creation et d'attachement d'un attribut a son element parent, ce 
n'est pas une erreur si I 'element parent possede deja un attribut de meme nom. Le dernier 
ajoutel'emporte. N ous reverrons cela un peu plus loin (voir Complements, page 319). 

Regie du pape 

Premier ajoute, premier ecrase: e'est cela la regie du pape. Autrementdit, le dernier ajoute I'emporte, comme 
on vientde le voir. Cette regie serta plusieurs reprises dans la suite. 

Exemple trivial 

Le premier exemple reprend la feuille de style qui nous avions vu a la section Suite de 
I 'exemple, page 270, avec laquelleil fallait obtenir le resultat suivant : 

interventionRecitant.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prologue> 
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Le Tableau de 1 'Operation de la Taille 

</prologue> 
<mesure No="l">L'aspect de 1 'apareil .</mesure> 
<mesure No="8">Fremissement en le voyant.</mesure> 
<mesure No="ll">Resolution pour y monter.</mesure> 
<mesure No="15">Parvenu jusqu'au hault;</mesure> 
<mesure No="20">descente dudit apareil .</mesure> 
<mesure No="22">Reflexions serieuses.</mesure> 
<mesure No="23">Entrelassement des soyes 

Entre les bras et les jambes.</mesure> 
<mesure No="27">Icy se fait l'incision.</mesure> 
<mesure No="31">Introduction de la tenette.</mesure> 
<mesure No="39">Ici Ton tire la piere.</mesure> 
<mesure No="44">Icy l'on perd quasi la voix.</mesure> 
<mesure No="48">Ecoulement du sang.</mesure> 
<mesure No="50">Icy l'on oste les soyes. </mesure> 
<mesure No="53">Icy l'on vous transporte dans le 1 it.</mesure> 
</recitant> 

I est immediat de transformer la feuille de style fusion.xsi pour utiliser I'instruction 

csl attribute : 



<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 



(si: output method='xml ' indent="yes" encodings' ISO-8859-1" /> 
csl : pa ram name="declamationFileRef " select^" 'decl amationTaille. 

select="document( $declamationFileRef )/texte" /> 

csl :template match="/"> 

<recitant> 

<xsl :apply-templates/> 

</recitant> 
'xsl :template> 

isl : tempi ate match="prologue"> 

<prologue> 

<xsl:value-of select="$declamation/titre"/> 

</prologue> 
'xsl :template> 

isl:template match="Numeros"> 
<xsl :for-each select="NoMesure"> 

<xsl variable name="i" select="position( )" /> 
<!-- c'est ici que cela change --> 
<mesure> 
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<xsl: attribute name="No"> 

<xsl:value-of select="."/> 
<xsl:attribute/> 

<xsl :value-of select="$declamatic 
</mesure> 



</xsl :for-each> 
</xsl :template> 



</X! 



<xsl :template m 
tylesheet> 



itch="text()V> 



Cette version n'apporte rien de mieux a celle que nous avionsdeja vue; el le meme un 
peu moins claire a la lecture. Comme nous I'avions deja dit a propos de I'instruction 
xsi element, I'instruction xsi : attributen'est vraiment interessante que si le nom de 
I 'attri but est calcule par le programme. Sinon, si c'estuniquementlavaleurqui estcalcu- 
leepar le programme, autant mettreleresultatdu calcul dans une variable etuti I iser un 
descripteur de valeur differee d' attri but, comme nous I'avions fait dans la version prece- 
dente du programme ci-dessus (voir section Suite de I 'exemple, page 270). 



Exemple plus evolue 

Nous allons maintenant ameliorer le programme vu a la section Exemple plus evolue, 
page 275, c'est-a-dire le rendre plus conforme aux vraies attentes, qui sont en fait d'obte- 
nir un resultattel quecelui-ci : 



2ncoding="IS0-8859-l"?> 



mapping.xml 

<?xml versio 
<mapping> 

<table>ACCORD</table> 
<ACC0RD> 

<DEDEC> 

<field>beginning_date</field> 
<type>BusinessDate</type> 

</DEDEC> 

<CCETF CHAR="1"> 

<field>state</field> 
<type>String</type> 

</CCETF> 

<N0ACA CHAR="6"> 

<f ield>company_id</field> 
<type>String</type> 

</N0ACA> 

<N0P0A VARCHAR2="35"> 

<field>contract_nbr</field> 
<type>String</type> 

</N0P0A> 

<CCPAA1 NUMBER="4"> 

<f i el d>country_code</f i el d> 
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<type>Integer</type> 
</CCPAAl> 
</ACC0RD> 

<table>COMPANY</table> 
<C0MPANY> 

<N0ACA CHAR="6"> 

<f i el d>company_i d</f i el d> 

<type>String</type> 
</N0ACA> 
<LSACA1 VARCHAR2="35"> 

<f i el d>company_name</f i el d> 

<type>String</type> 
</LSACAl> 
<CCPAA1 NUMBER="4"> 

<field>country_code</field> 

<type>Integer</type> 
</CCPAAl> 
<LAACA1 VARCHAR2="35"> 

<field>address</field> 

<type>String</type> 
</LAACAl> 
<URL VARCHAR2="40"> 

<field>URL</field> 

<type>String</type> 
</URL> 
<STATRAT VARCHAR2="1"> 

<field>quality_code</field> 

<type>String</type> 
</STATRAT> 
</C0MPANY> 
</mapping> 

II s'agitdonc d'ajouter a chaque element un attribut dormant son type SQL ainsi quesa 
longueur, sauf si la longueur n'est pas une information pertinente (cela ne concerne que 
les dates, dansnotreexemple: l'element<DEDEC>). 

Le changement est tres simple a effectuer, car la structure du programme XSLT ne 
change pas. Par commodite, nous allons toutefois declarer des variables qui contiendront 
le nom et la valeur de ces nouveaux attributs a emettre dans I e document resultat. 

La regie pri nci pale du programme XSLT que nous avions mis au point etait eel le-ci : 



1 :template ma 


tch= 


table" 




<table> 








<xsl:value-of 


sele 


ct="@name'7> 


</table> 








<xsl :element 


name= 


"{@nam 


}"> 


<xsl:for-e 


ach s 


elect= 


tab"> 


<xsl:va 


riabl 


e name 


"elementN 
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select=" norma lize-space( 

preceding-sibl ing: :text( )[1] 

<xsl :element name="{SelementName}"> 

<field> 

<xsl :cal 1 -template name=" traduction") 

<xsl :with-param name="motId" select="SelementName" /> 
</xsl: call -template) 
</field> 
<type> 

<xsl :variable name="typeSQL" select="normal ize-space( 

foil owing- sibling: :text()[l] 
)"/> 
<xsl :choose> 

<xsl:when test="contains( StypeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 

<xsl:v 
<x: 

</xsl :when> 

<xsl:when test="contains( StypeSQL, 'NUMBER' )" > 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl :choose> 
</type> 
</xsl :element> 

</xsl:for-each> 
</xsl : element) 

</xsl : tempi ate> 

Etant donne la chaine de caracteres -numberu)" par exemple, valeur de la variable 
typeSQL, le nom du type proprement dit est donne par I'expression substring-beforec 
StypeSQL, 'c ), c'est-a-dire la sous-chaine qui s'arrete juste avant la •(', 

La fonction substnng-beforeo est une fonction standard XSLT, I'une des rares qui 
permettededecortiquerune String. Elleasonsymetrique, substring-aftero.qui valui 
aussi nousservir : 

<xsl :variable name="typeSQL" select="normal ize-space( 

following-sibling: :text()[l] 



ime="attributeName" 
;lect="substring-before( StypeSQL, '(' )"/> 
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-- dans ce cas, attributeName vaut "NUMBER" --> 

si :variable name="typeSQL-after" 

select="substring-after( StypeSQL, '(' )"/> 

-- et typeSQL-after vaut "4)" --> 

si variable name="attributeValue" 

select="substring-before( $typeSQL-after, ')' )"/> 

-- et final ement attributeValue vaut "4" --> 

A I'issuedeces instanciationsde variables, on tient lenom et la valeur del'attributcou- 
rant. Mais il faut verifier quece nom n'est pas unechaine vide, car I'instanciation d'un 
attri but dont le nom est vide n'a clairement aucun sens, et provoque une erreur. 

Or, il peutarriver quele nom soitvide, parcequelafonction substring-beforeO ren- 
voie unechaine vide si lemarqueur recherche, une "(" dansnotreexemple, n'existepas 
dans la chaine examinee. Et de fait, cela se produira pour le type date, qui ne mentionne 
pas de longueur. 

<xsl :variable name="typeSQL" select="normal ize-space( 



<xsl rvariable name="attributeName" 

select="substring-before( StypeSQL, '(' )"/> 

<xsl variable name="typeSQL-after" 

select="substring-after( StypeSQL, '(' )"/> 

<xsl variable name="attributeValue" 

select="substring-before( $typeSQL-after, ')' )"/> 

<xsl:if test="$attributeName"> 

<xsl :attribute name="{$attributeName}" > 
<xsl:value-of select="$attributeValue"/> 

</xsl: attribute) 
</xsl:if> 

La valeur de I'attribut test est convertie en booleen ; on rappelle (voir Fonctions Boo- 
le'ennes, page 636) que la conversion d'une String en booleen donne true si et seulement 
si la String n'est pas de longueur nulle, d'ouletestci-dessus. 

Le programme XSLT se deduit de toutes ces remarques, et donne bien le resultat montre 
au debut decette section. 

mapping.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 
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xmlns:xsl -"http://www.w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:output method='xml' indent="yes" encoding=' ISO-8859-1 ' /> 

<xsl : pa ram name="dicoFileRef ">fields.xml</xsl :param> 

<xsl variable name="Dictionnaire" select="document($dicoFileRef )/fields"/ 

<xsl :template match="/"> 

<mapping> 

<xsl :apply-templates/> 

</mapping> 
</xsl :template> 



<xs1: van" able 

name="saTraduction" 
select="$Dictionnaire/field[@id=$motId]" /> 

<xsl : val ue-of select="normalize-space($saTraduction)" /> 
</xsl :template> 

<xsl :template match="table"> 

<table> 

<xsl :value-of select="@name"/> 

</table> 

<xsl:element name="{@name}"> 

<xsl :for-each select="tab"> 

<xsl :variable name="elementName" 

select= "normal ize-space( 

preceding-sibling: :text()[l] 
)"/> 
<xsl :element name="{$elementName}"> 

<xsl :variable name="typeSQL" select="normal ize-space( 

following-sibling: :text()[l] 



ame="attributeName" 
2lect="substring-before( StypeSQL, '(' )"/> 



ame="typeSQL-after" 
2lect="substring-after( StypeSQL, '(' )"/> 



2 name="attributeValue" 
select="substring-before( StypeSQL-after, ')' )"/> 
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<xsl :1f test="$attributeName"> 

<xsl: attribute name="{$attributeName)" > 
<xsl:value-of select="$attributeValue"/> 

</xsl:attribute> 
</xsl:if> 

<field> 

<xsl : call -tempi ate name="traduction"> 

<xsl :with-param name="motId" select="$elementName" /> 

</xsl :call-template> 
</field> 

<type> 

<xsl :choose> 

<xsl:when test="contains( StypeSQL, 'CHAR' )" > 

<xsl :text>String</xsl :text> 
</xsl :when> 

<xsl :when test=" 
<xsl :text>Bus 
</xsl :when> 

<xsl:when test="contains( StypeSQL, 'NUMBER' 

<xsl :text>Integer</xsl :text> 
</xsl :when> 
</xsl :choose> 
</type> 
/xsl:element> 



<xsl :template match="text( )"/> 
</xsl:stylesheet> 



Variante syntaxique namespace="..." 

n peut si I 'on veut aj outer un attri but namespace, comme ceci : 
xsl : attribute 



<xsl attribute name=". 
<!-- modele de tre 



<!-- fin du modele de trc 
</xsl :element> 
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L'attribut namespace (une chaine de caracteres) permet d'affecter un domaine nominal 
a I'attribut qui va etre cree. Un descripteur de valeur differee d'attribut est accepte ici. 
La chaine de caracteres qui constitue le domaine nominale n'est pas analysee par le pro- 
cesseurXSLT, done aucun controle de validite de cette chaine n'est effectue. 

Exemple avec namespace="..." 

Nous reprenons I 'exemple vu a la section Exemple avec namespace="...", page 288, dans 
lequel nous dedarons un domaine nominal uniquement pour I'attribut : 

mapping.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml' indent="yes" encoding=' ISO-8859-1 ' /> 
<xsl:param name="declamationFileRef " select=" 'declamationTail le.xml ' " /> 
<xsl variable name="decl amation" 

select="document( SdeclamationFileRef )/texte" /> 



</; 



1 :template match="/"> 
<recitant> 

<xsl :apply-templates/> 
</recitant> 
tempi ate> 



<xsl :template match="prologue"> 
<prologue> 

<xsl :value-of select="$declamation/titre 
</prologue> 
</xsl :template> 



<xsl : tempi ate match="Numeros"> 
<xsl :for-each select="NoMesure"> 

<xsl : variable name="i" select="position( )" /> 
<xsl:element name="mesure" > 
<xsl :attribute name="No" 

namespace^" http://concerts.anac reon.fr/viole-de-gambe"> 
<xsl:value-of select=".'7> 
</xsl: attribute) 
<xsl :value-of select="$decl amation/paroles/p[position( ) = $i]"/ 



:elen 



nt> 



</xsl :for 
</xsl :templ ate> 



ich> 



(si :template rr 
:stylesheet> 
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<?xml version="1.0" encoding="IS0-8859-l"?> 
<recitant> 
<prologue> 
Le Tableau de 1'Operation de la Taille 
</prologue> 
<mesure xmlns:nsO="http: //concerts. anacreon 

L'aspect de 1 'apareil .</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Fremissement en le voyant.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Resolution pour y monter.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Parvenu jusqu'au hault;</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

descente dudit apareil .</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Reflexions serieuses .</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Entrelassement des soyes 
Entre les bras et les jambes.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Icy se fait 1 'incision. </mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Introduction de la tenette.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Ici 1 'on tire la piere.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Icy l'on perd quasi la voix.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Ecoulement du sang.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Icy l'on oste les soyes. </mesure> 
<mesure xmlns:nsO="http: //concerts. anacreon 

Icy l'on vous transporte dans le 1 it.</mesure> 
</recitant> 

On voit qu'ici, le processeur XSLT a ete oblige d'inventer une abreviation pour le 
domaine nominal choisi, car la declaration xmins="..." prend place dans I'element 
<mesure>, mais ne doit pas pour autants'appliquer a cet element. Si le domaine nominal 
avait ete declare sans abreviation, cela aurait ete un domaine nominal par defaut, qui se 
serait done applique a I'element <mesure> lui-meme, chose que l'on veut precisement 
eviter. 

M ais la encore, il reste plus simple de declarer le domaine nominal souhaite (avec son 
abreviation) dans la racinedu programme XSLT, etd'uti I iserexplicitementcette abrevia- 
tion partoutoue'estnecessaire, comme dans I'exemplede la section Autre exemple sans 
namespace="...", page 286. 
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mapping. xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 
xmlns:vdg=" http://concerts.anac reon.fr/viole-de-gambe" 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 
<xsl:param name="declamationFileRef " select=" 'declamationTaille.xml ' " /> 
<xsl : variable name="decl amation" 

select="document( SdeclamationFileRef )/texte" /> 

<xsl :template match="/"> 
<recitant> 

<xsl :apply-templates/> 
</recitant> 
</xsl :templ ate> 

<xsl : tempi ate match="prologue"> 
<prologue> 

<xsl :value-of select="$declamation/titre"/> 
</prologue> 
</xsl :template> 

<xsl :template match="Numeros"> 
<xsl :for-each select="NoMesure"> 

<xsl variable name="i" select="position( )" /> 
<xsl:element name="mesure" > 
<xsl :attribute name="vdg:No"> 
<xsl :value-of select="."/> 
</xsl: attribute) 

<xsl:value-of select="$declamation/paroles/p[position( ) = $i]"/> 
</xsl:element> 
</xsl :for-each> 
</xsl :template> 



<xsl :template match="text( )"/> 
</xsl: stylesheet) 



<?xml version="1.0" encoding="IS0-8859-l"?> 

<recitant xmlns:vdg=" http://concerts.anacreon.fr/viole-de-gambe"> 
<prologue> 
Le Tableau de TOperation de la Taille 
</prologue> 

<mesure vdg:No="l">L'aspect de 1 'apareil .</mesure> 
<mesure vdg:No="8">Fremissement en le voyant.</mesure> 
<mesure vdg:No="ll">Resol ution pour y monter.</mesure> 
<mesure vdg:No="15">Parvenu jusqu'au hault;</mesure> 
<mesure vdg:No="20">descente dudit apareil .</mesure> 
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<mesure vdg:No="22">Reflexions serieuses.</mesure> 
<mesure vdg:No="23">Entrelassement des soyes 
Entre les bras et les jambes.</mesure> 



<mesu 


e vdg:No= 


"27' 


>Icy se 


fait 1' incision. </mesure> 


<mesu 


e vdg:No= 


"31' 


Mntroduction de la tenette.</mesure> 


<mesu 


e vdg:No= 


"39' 


>Ic1 r 


Dn tire la piere.</mesure> 


<mesu 


e vdg:No= 


"44' 


>Icy r 


Dn perd quasi la voix.</mesure> 


<mesu 


e vdg:No= 


"48' 


>Ecoule 


Tient du sang.</mesure> 


<mesu 


e vdg:No= 


"50' 


>Icy T 


Dn oste les soyes. </mesure> 


<mesu 


e vdg:No= 


"53' 


>Icy r 


jn vous transporte dans le lit.</ 


</recita 


t> 









Instruction xs I: attribute-set 
Bande-annonce 

Concert.xml 

<?xml version="1.0" encoding="UTF-16" standalc 



<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

</Concert> 

instruction <xsi : attribute-set name=" . . . "> est utilisee pour definir des groupe- 
ments d'attributs qui reviennent en plusieurs endroits d'un programme, lors de I'instan- 
ciation d'elements (par instruction <xsi :eiement> ) dans le document resultat. Le 
regroupementde la definition deces attributs facilite la maintenance ou les evolutions du 
programme. 



Concert.xsl 



;ion="1.0" encoding="UTF-16"?> 

;sheet xmlns :xsl="http: //www. w3.org/1999/XSL/Tra 



<xsl:output method='htmr encodings' ISO-8859-1' /> 



<xsl :attribute-set name="body-attributes"> 

<xsl attribute name="leftmargin">150</xsl :attribute> 
<xsl attribute name="bgcolor">#ddeeff</xsl :attribute> 
<xsl attribute name="text">bl ack</xsl :attribute> 

</xsl:attribute-set> 
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<xsl : tempi ate match="/"> 
<html> 
<head> 

<title><xsl:value-of select="/Concert/Entete"/></title> 
</head> 
<xsl :element name="body" use-attribute-sets="body-attributes"; 

<xsl :apply-templates/> 
</xsl :element> 
</html> 
</xsl :template> 

<xsl :template match="Ensemble"> 

<H2 align="center"> Ensemble <xsl : value-of select=" . "/></H2> 
</xsl :templ ate> 



<xsl :template match="text()"/> 



</xsl: stylesheet) 

Resultat 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title> «Les Concerts d'Anacréon» </title> 
</head> 
<body leftmargin="150" bgcolor="#ddeeff " text="black"> 

<H2 align="center"> Ensemble «A deux violes esgales» </H2> 
</body> 
</html> 



Syntaxe 



L'instruction <xsi :attribute-set> permet de definir un ensemble d'attributs qui pour- 
ront etre attaches en une seulefois a un element en utilisant l'instruction <xs:eiement 
name= n ..." use-attri bute-sets=" . . .">, ou bien en utilisantun element source I itteral 
avec unattributxsi : use-attri bute-sets="... n (voir Variante de I'exemple, page 312). 



II y a aussi une autre instruction qui peut utiliser I'attribut use-attri bute-sets dans le meme but, c'est l'instruc- 
tion <xsi : copy>, que nous verrons plus loin (voir Instruction xshcopy, page 321). Attention a ne pas confondre 
<xsi :copy> et <xsi :copy-of>, dejavue (voir Instruction xsl:copy-of, page 156). 

xsl :attribute-set 

<xsl :attribute-set name=" . . . "> 

<!-- modele de transformation propre a xsl :attribute-set --> 

<xsl :attribute name=" . . . "> 
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<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl :attribute> 
<xsl :attribute name="..."> 

<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl:attribute> 

<!-- etc. autant d'attributs que 1'on veut, mais rien que des attributs --> 
<!-- fin du modele de transformation propre a xsl :attribute-set --> 
</xsl:attribute-set> 

L'instruction xsi : attri bute-set doit apparattre en tant qu' instruction de premier niveau. 

Semantique 

L'instanciation d'une instruction xsi :attribute-set consiste a instancier toutes les ins- 
tructions xsi :attribute qu'elle contient. 

Bien que I'element xsi :attribute-set soit une instruction de premier niveau, comme 
I'est la definition d'une variable ou d'un parametre global, elle n'est pas instanciee en 
meme temps que les variables ou parametres globaux. 

Pour une variable global e, l'instanciation n'a lieu qu'uneseulefois, avantquelemoteur 
de transformation ne commence a traiter la racine du document ; le nceud contexte pour 
devaluation de cette variable globale est le noeud racinedel'arbreXM L du document. 

Pour l'instruction xsi :attnbute-set, l'instanciation est differee jusqu'au moment ou 
elle est effectivement necessaire a l'instanciation d'une instruction xsi element 
reclamant cet attribute-set. Bien plus, l'instanciation du modele de transformation 
d'une instruction xsi :attribute-set est relancee a chaque fois qu'une instruction de 
xsi element referencant cet attribute-set est instanciee. 

Le noeud contexte utilise pour l'instanciation d'une instruction xsi :attribute-set estle 
meme que celui qui est actif lors de l'instanciation de l'instruction xsi element qui fait 

appel a Cet attribute-set. 

Parexemple, l'instruction : 

<xsl :attribute-set name="truc"> 
<xsl :attribute name="machin"> 
<xsl:value-of select="."/> 
</xsl :attribute> 
<xsl :attribute name="bidule"> 

<xsl:value-of select=" . . "/> 
</xsl:attribute> 
</xsl:attribute-set> 

peut etre reinstanciee de nombreuses fois, avec a chaque fois un noeud contexte different 
(done des valeurs differentes pour les expressions evaluees par le sei ect des xsi : vai ue- 

of). 
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Dece point devue (invariance du nceud contexte entre I'appel et I'instanciation), ins- 
truction xsl :attribute-set Se COmporte COmme instruction xsl:template name= 

". . .", mais avec la grande difference qu'il n'existe aucun moyen pour transmettre un 
argument ou parametre a une instruction xsi :attribute-set (la seule chose effective- 
menttransmise est done I e nceud contexte). 

Rien n'empeche pourtant une instruction xsl :attribute-set de faire reference a des 
variables ou parametres, maisetantdonne les regies de visibi lite (voir Regies de visibi- 
lity page 212), ce ne peut etre que des variables ou parametres globaux, qui ont une 
valeur fixee une fois pour toutes. 

Variante syntaxique use-attribute-sets="..." 

On peut si I'on veut ajouter un attribut use-attribute-sets, commececi : 

xsl :attribute-set 

<xsl :attribute-set name="..." use-attribute-sets=" . . . "> 

<!-- modele de transformation propre a xsl :attribute-set --> 
<xsl attribute name="..."> 

<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl attribute --> 
</xs1:attribute> 
<xsl: attribute name="..."> 

<!-- modele de transformation propre a xsl :attribute --> 

<!-- fin du modele de transformation propre a xsl :attribute --> 
</xsl: attribute) 

<!-- etc. autant d'attributs que I'on veut, mai 
<!-- fin du modele de transformation propre a > 
</xsl:attribute-set> 

L'attribut use-attribute-sets=". .." (une liste de noms d'attribute-set separes par 
desespacesblancs) permetde placer dans I'attribute-set en coursde construction des 
attributs provenantd'autres attribute-set. Bien sur, et commetoujours dans ce genre 
de situation, les references circulaires sont interdites, car elles sont impossibles a traiter 
et denuees de sens. 



Exemple 



Remarque 

Cet exemple Utilise I'instruction <xsl : element name="..." use-attribute-sets="...">. 

On voitsouventla notion d'attibute-set illustree par des exemples dans ledomainede 
I'enrichissementtypographiqueen HTM L detextesavisualisersurun navigateur.Jen'ai 
jamais trouvece genre d'exempletres bien choisi, car CSS estjustement fait pour ca, et 
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c'estbien plus simple qu'avecXSLT : il suffit de definir un etun seul attri but class dans 
I 'element concerne, et, dans un fichier a part, de definir la classe CSS correspondante 
avec toutes lescombinaisons d'attributs typographiques que I'on veut. Nous allons done 
nousecarter deliberementdu domainedes attri buts typographiques pour illustrer I 'utili- 
sation d'un regroupement d'attributs par attitmte-set. 

Nous allons supposer ici que nous voulons creer un fichier XML resumant les informa- 
tions de contenu des plages d'un CD, avec, pour chacune d'entre el les, les artistes qui 
interviennent, letitrede la piece jouee, eteventuellement d'autres informations encore. 
Le but est de pouvoir ensuite utiliser ce fichier comme I'une des sources d'information 
pour la realisation de la plaquette du disque, les declarations pour la perception par les 
artistes des droits sur les ventes (qui peuvent etre au prorata du minutage de I eur partici- 
pation), etc. 

Voici I'allure dece fichier (assez sparti ate, n'etant pas destine a etre affiche) : 



plagesCD.xml 



i="1.0" encoding="IS0-8859-l"?> 



<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded" org="fech"> 
Grave 
</plage> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded" vlc="dsmp"> 
Presto / Prestissimo 
</plage> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded"> 
Adagio 
</plage> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
v!2="oded" vlc="dsmp" org="fech"> 
Presto Recit de basse 
</plage> 
</plages> 

Les codes utilises sont repertories dans un autre fichier XML, constitue a part (ce fichier 
n'intervient pas dans la transformation XSLT a realiser ; on le montre seulement pour 
fixer les i dees) : 

codes PI ages .xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
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<artistes> 

<artiste id="cplu" nar 

<artiste id="nspt" nai 

<artiste id="eblq" nar 

<artiste id="fmrt" nar 

<artiste id="oded" nar 

<artiste id="fech" nar 

<artiste id="dsmp" nar 

</artistes> 

<instruments> 

<instrument id="vdg' 
<instrument id="cl v' 
<instrument id="thb' 
<instrument id="vll' 
O'nstmment id="vl2' 
<instrument id="org' 
<instrument i d=" vl c' 

</instruments> 



^"Christine Plubeau"/> 
2="Noelle Spieth"/> 
;="Eric Bellocq'7> 
;="Frederic Martin"/> 
;="0dile Edouard"/> 
s="Freddy Eichelberger"/> 
3="David Simpson"/> 



ne="Viole de gambe"/> 
ne="Clavecin"/> 
ne="Theorbe"/> 
ne="Violon baroque"/> 
ne="Violon baroque"/> 
ne="0rgue positif "/> 
ne="Violoncelle baroque 



La transformation XSL que nous allons voir doit aboutirau fichier piagesCD.xmi en par- 
tantdu fichier sonates-jacquet-dig.xmi montre ci-dessous : 

sonates-jacquet-dlg.xnil 

<?xml version="1.0" encoding="UTF-16"?> 



<compositeur> 

Elizabeth Jacquet de 1 
</compositeur> 

<recueil> 

Manuscrit des sonates 
copiees par Sebastien 



<sonate> 
<titre> 

Suonata IV en sol mineur 

e Violoncello obligato co 
</t1tre> 
<mouvement effectif="bc-violo 

<titre>Grave</titre> 
</mouvement> 
<mouvement effectif="tutti"> 

<titre>Presto / Prestissimo</titre> 
</mouvement> 
<mouvement effectif="bc-violons"> 



i 2 Violir 



-orgue") 
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<titre>Adagio</titre> 
</mouvement> 
<mouvement effectif="tutti-orgue"> 

<titre>Presto Recit de basse</titre> 
</mouvement> 
;onate> 



</sonates> 

Dans le fichier de depart de la transformation, nous avons done des attributs representant 
I ' eff ectif par un code, I a correspondance entre I e code et ce qu'il represente etant a etabl i r 
dans le programme X SLT, sur le principe suivant : 

• be (basse continue) = clavecin + violedegambe+theorbe 

• violons = les deux violons 

• tutti = be + violons + violoncelle 

Nous allons done definir un attibute-set pour chacune de ces combinaisons : 



:attribute-set name= 
<xs1: attribute natr 
<xsl: attribute natr 
<xsl: attribute nan 

<sl:attribute-set> 



="vdg">cplu</xsl:attribute> 
="clv">nspt</xs1:attribute> 
="thb">eblq</xsl:attribute> 



<x: 



:attribute-set name="vls"> 
<xsl: attribute name="vll">fmrt</xsl :attribute> 
<xsl attribute name="vl2">oded</xsl :attribute> 
7xsl:attribute-set> 



<xs 



:attribute-set natr 
<xsl attribute nan 
.1 :attribute-set> 



= "tt" 



ttribute-sets="bc \ 
cl">dsmp</xsl :attribute> 



On voit ici I'inteYet de I 'uti I isati on de I'attribut use-attribute-sets pour la definition 
d'un attribute-set : on n'a pas a repeter les declarations d'attributs faisant partie des 
groupes « be » ou « vis », ce qui maintient une meilleure coherence de I 'ensemble en cas 
de modification de I 'un de ces groupes. 

Ayant ces groupements d'attributs, on peut alors traiter le fichier d'entree : 

<xsl :template match="sonate"> 

<xsl :for-each select="mouvement"> 



<xsl :choose> 

<xsl :when test="@effectif = 'bc-violons-orgue'"> 

<xsl:element name="plage" use-attribute-sets="bc vis 
<xsl attribute name="org">fech</xsl :attribute> 
<xsl:value-of select="titre"/> 



Instruction xsl:attribute-set 



</xsl :element> 
</xsl:when> 

Pour la combinaison « bc-violons-orgue», il suffit de prendre les groupements d'attri- 
buts « bc»et«vls», etil ne manque plus que I'orgue, qu'on rajoute« a la main ». 
Le programme de transformation est done lesuivant: 

plagesCD.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml' indent="yes" encodings' ISO-8859-1 ' /> 

<xsl :attribute-set name="bc"> 

<xsl attribute name="vdg">cplu</xsl :attribute> 

<xsl rattribute name="cl v">nspt</xsl :attribute> 

<xsl rattribute name="thb">eblq</xsl :attribute> 
</xsl:attribute-set> 

<xsl :attribute-set name="vls"> 

<xsl: attribute name="vll">fmrt</xsl :attribute> 

<xsl attribute name="vl2">oded</xsl :attribute> 
</xsl:attribute-set> 

<xsl:attribute-set name="tt" use-attribute-sets="bc vls"> 

<xsl rattribute name="vcl ">dsmp</xsl :attribute> 
</xsl:attribute-set> 

<xsl : tempi ate match="/"> 

<plages> 

<xsl :apply-templates/> 

</plages> 
</xsl :templ ate> 

iate"> 



<xsl :choose> 

<xsl :when test="@effectif = 'bc-violons-orgue'"> 

<xsl:element name="plage" use-attribute-sets="bc vis' 
<xsl attribute name="org">fech</xsl :attribute> 
<xsl:value-of select="titre"/> 
</xsl :element> 
</xsl:when> 
<xsl:when test="@effectif = 'bc-violons'"> 

<xsl :element name="plage" use-attribute-sets="bc vis 1 

<xsl:value-of select="titre"/> 
</xsl :element> 
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<xsl:when test="8effectif - 'bc-violoncelle'"; 
<xsl : element name="plage" use-attribute-st 
<xsl: attribute name="vlc">dsmp</xsl :a1 
<xsl:value-of select="titre"/> 

</xsl :when> 

<xsl :when test="@effectif = 'tutti-orgue' "> 
<xsl : element name="plage" use-attribute-st 
<xsl : attribute name="org">fech</xsl :at 
<xsl:value-of select="titre"/> 
</xsl:element> 
</xsl :when> 
<xsl :when test="@effectif = 'tutti'"> 

<xsl:element name="plage" use-attribute-se 

<xsl :value-of select="titre"/> 
</xsl :element> 



</xsl:for-each> 
</xsl :template> 

<xsl :template match="text( )"/> 

</xsl:stylesheet> 

Le resultat obtenu est bien celui annonce plus haut (voir fichier piagesCD.xmi). On 
remarquera I 'inconvenient inevitable d'avoir a repeter instruction <xsi :eiement> pour 
chaque<xsi :when> : la factorisation serai t possible, a condition de ne pas utiliser I'attri- 
but use-attribute-sets, ou alors de I'utiliser avec la meme valeur partout, ce qui est 
malheureusement contradictoire avec le but poursuivi. 

Variante de lexemple 

Remarque 

Cet exemple utilise un element source XML litteral (hors du domaine nominal « xsl ») associe a un attribut 
xsl :use-attribute-sets=". . ." (qui lui, est dans le domaine nominal « xsl »). 



Au lieu d'utiliser I 'instruction <xsi :eiement> pourappeler leou les attribute-set uti- 
les, il est possible d'utiliser un element source litteral, etd'employer I'attributxsi :use- 
attribute-sets= n . ..", comme ceci : 

plagesCD.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

I <xsl: stylesheet 
xmlns: xsl ="http: //www. w3.org/1999/XSL/Transform" 
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<xsl:output method='xml' indent="yes" encodings' ISO-8859-1' /> 



<xsl :attribute-set name="bc"> 

<xsl : attribute name="vdg">cplu</xsl :attribute> 
<xsl :attribute name="cl v">nspt</xsl :attribute> 
<xsl :attribute name="thb">eblq</xsl :attribute> 

</xsl:attribute-set> 

<xsl:attribute-set name="vls"> 

<xsl attribute name="vl l">fmrt</xsl :attribute> 
<xsl attribute name="vl2">oded</xsl :attribute> 

</xsl:attribute-set> 

<xsl:attribute-set name="tt" use-attribute-sets="bc vls"> 

<xsl :attribute name="vcl ">dsmp</xsl :attribute> 
</xsl: attribute-set) 

<xsl : tempi ate match="/"> 

<pl ages> 

<xsl :apply-templates/> 

</plages> 
</xsl :template> 

<xsl : tempi ate match="sonate"> 

<xsl :for-each select="mouvement"> 

<xsl :choose> 

<xsl :when test="@effectif = 'bc-violons-orgue' "> 
<plage xsl :use-attribute-sets="bc vls"> 

<xsl :attribute name="org">fech</xsl :attribute> 
<xsl:value-of select="titre"/> 
</plage> 
</xsl :when> 

<xsl:when test="@effectif = 'bc-violons'"> 
<plage xsl :use-attribute-sets="bc vls"> 

<xsl:value-of select="titre"/> 
</plage> 
</xsl:when> 

<xsl:when test="@effectif = 'bc-violoncel le'"> 
<plage xsl :use-attribute-sets="bc"> 

<xsl :attribute name="vlc">dsmp</xsl :attribute> 
<xsl:value-of select="titre"/> 
</plage> 
</xsl :when> 

<xsl :when test="@effectif = 'tutti-orgue' "> 
<plage xsl :use-attribute-sets="tt"> 

<xsl attribute name="org">fech</xsl :attribute> 
<xsl:value-of select="titre"/> 
</plage> 
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<xsl :when test= 


"@effectif = 'tutti 




<plage xsl 


use-attribute-sets= 


"tt 


<xsl:va 


lue-of select="titr 


eV 


</plage> 






</xsl:when> 






</xsl :choose> 






</xsl :for-each> 






</xsl :template> 






<xsl :template match="text( ) 


■/> 





</xsl: stylesheet) 

L'effetdecette version est exactementlememe que dans la version precedente. Comme 
dans ce programme, i I n'yaapriori pas devolution envisageablequi pourrait necessiter 
de rendre variable le nom de I 'element <pi age>, on peut a la rigueur penser que cette ver- 
sion esttreslegerementmeilleure, mais la difference est tout dememeassez infime. 



Commentaire de I'exemple 

Remarque 

Cetexemple utilise un attribute-set simule parun modele m 



Ceci dit, comme on I'a deja remarque un peu plus haut, la notion a" attribute-set 
souffre peutetre un peu du manque depossibi lite de parametrage. Mais i I faut bien voir 
qu'un regroupement d'attributs n'est jamais qu'un regroupement d'attributs, et qu'un 
regroupementd'attributs, 9a ne doit pas etre si terrible que ga a realiser avec lesmoyens 
du bord, qui sontdejaassez consequents (minederien) : 



<xsl :template name="bc"> 

<xsl :attribute name="vdg">cpl u</xsl :attribute> 
<xsl attribute name="cl v">nspt</xsl :attribute> 
<xsl :attribute name="thb">eblq</xsl :attribute> 

</xsl :template> 



<xsl :template name=" 
<xsl: attribute r 
<xsl: attribute r 

</xsl :template> 

<xsl : tempi ate name="tt"> 
<xsl :cal 1 -template r 
<xsl icall-template r 
<xsl: attribute name= 

</xsl :template> 



:l">dsmp</xsl: attribute) 
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Chapitre 6 

On a ici des regroupementsd'attributs, qui n'ontrien aenvier aceux de la section prece- 
dente, et qui en plus, ne sont pas li mites en possibility de parametrage, puisque rien 
n'empecherait de transmettre a ces modeles nommes des arguments comme on peut le 
faireavec n'importequel modelenomme. 

Note 

interdiction de circularite, dans ce cas, semble disparaitre, puisqu'aucune interdiction de ce genre n'est asso- 
ciee aux modeles nommes. En fa it e I le ne disparaitpas vraiment : un modele nomme A peuteffectivementappe- 
lerun modele nomme B, qui en retour, peut appeler le modele A. On estalors dans un cas de recursion mutuelle, 
parfaitementautorisee. Mais evidemment, toute recursion, fut-elle croisee ou mutuelle, doit finir par s'arretersur 
une certaine condition. Sinon c'est une recursion infinie, done une erreur, qui se manifestera a I'execution par la 
consommation immediate de toute la memoire disponible. 

Le plus fort, c'est que si I'on met en ceuvre une transformation avec cette facon de rea- 
liser les regroupements d'attributs, on aboutit a une solution globalement plus simple : 
transformation plus simple et fichier d'entree plus simple. Pourquoi ? 
Parcequeseserait plussimple si I'on pouvaitaj outer des attribute-sets petit a petit, au 
fur et mesure qu'on decouvre dans la source XML des informations qui impliquent d'en 
ajouter. Malheureusement, ce n'est pas possible. II fautdonner en une seule fois la liste 
des attribute-sets a prendre en compte. On pourraiteventuellementpenseraconstituer 
cette liste petit a petit, sous forme d'une chaine de caracteres qui serait ensuite fournie 
comme valeur pour I'attribut use-attribute-sets (mais n'oublions pas qu'une variable 
n'est pas modifiable, qu'il n'y a pas d' iteration possible, etquela poursuitede cette idee 
exigeraitlamiseen place d'un modelenomme recursif) : 

<xsl :element name="plage" use-attribute-sets="{$laListe}"> 

Pas de chance, I'attribut use-attribute-sets n'est pas prevu pour accepter des descrip- 
teurs de valeurs differees d'attribut ; c'est done inutile de s'acharner a contourner cette 
difficulty c'est perdu d'avance. 

On est done oblige d'ajouter les attribute-sets en une seule fois, et c'est ce qui oblige 
le source XM L a fournir toute une serie decodes qui donnent toute information neces- 
saireen une seule fois: 

I<mouvement effectif="bc-violons-orgue"> 
<titre>Grave</titre> 
</mouvement> 

et non pas : 

<mouvement> 

<titre>Grave</titre> 
<effectif> 

<basseContinue/> 
<violons/> 
<orgue/> 
</effectif> 
</mouvement> 
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;pitre 6 

Pourtant la deuxieme solution est plus i nteressante, car el I e est plus souple et plus 
simple : on ajouteou retire cequ'on veut, sans etre oblige d'inventer un nom decombi- 
naison pourchaquecombinaison utile. 

Mais precisement, cette deuxieme solution, plus interessante, est compatible avec une 
transformation XSLT basee sur des regroupements d'attributs par model es nommes. 

Lefichier sourceXML estmaintenantconstituecommececi : 

sonates- jacquet-dl g.xml 

xml version="1.0" encoding="UTF-16"?> 



<compositeur> 

Elizabeth Jacquet de la Guerr 
</compositeur> 

<recueil> 

Manuscrit des sonates en duo 
copiees par Sebastien de Bros 



Suonata IV en sol mineur a 2 Violini : 
e Violoncello obligato con organo 
</titre> 

<titre>Grave</titre> 
<effectif> 

<basseContinue/> 

<orgue/> 
</effectif> 
</mouvement> 
<mouvement> 

<titre>Presto / Prestissimo</titre> 
<effectif> 

<tutti/> 
</effectif> 
</mouvement> 
<mouvement> 

<titre>Adagio</titre> 
<effectif> 

<basseContinue/> 
<violons/> 
</effectif> 
</mouvement> 
<mouvement> 

<titre>Presto Recit de basse</titre> 
<effectif> 
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<tutti/> 
<orgue/> 
</effectif> 
</mouvement> 
</sonate> 



lates a suivre ici - 



Le principe pour real i ser la transformation est tres simple: on instancie une <piage>, 
puis tout de suite apres, on instancie lesattributs qui sontassocieSacette<piage>, puis 
enfin on instancie letitrede la plage: 

<plage> 

<xsl :apply-templates select="effectif " /> 

<xsl:value-of select="titre" /> 
</plage> 

C'estl'instruction : 

<xsl :apply-templates select="effectif " /> 

qui va instancier les attributs necessaires au fur et a mesure que les elements contenus 
dans <effectif> sont decouverts. 

Comment? 

La regie (par defaut) : 

I <xsl : tempi ate match="effectif "> 
<xsl :apply-templates /> 
</xsl:template> 

va relancer la recherche de motif sur les elements enfants de <effectif> ; on va done 
ecrire une regie par enfant possible. Par exemple, pour I'element <basseContinue/>, on 
va avoir la regie: 

I <xsl :template match="basseContinue"> 

<xsl : call -tempi ate name="bc"/> 
</xsl :template> 

ce qui aura pour effet d'instancier tous les attributs regroupes dans le modele nomme 
« be ». 

II suffit done d'ecrire une regie comme celle-ci pour chaque element possible enfant de 
<effectif>. On voit la souplesse que cela procure : si on enleve ou ajoute un element 
dans la description de I'effectif, il n'y a rien a changer dans le programme XSLT. Dans la 
solution precedents cela n'aurait pas ete necessairement vrai : si I'ajout ou la suppres- 
sion avait fait retomber sur une combinaisondeja uti I isee par ail leurs, il n'y aurait rien eu 
a changer ; maissinon, il aurait fallu ajouter un <xsi :when> dans le <xsi :choose>, cor- 
respondent a la nouvellecombinaison. 
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Si maintenant on invente une nouvelle categorie (par exemple <vents>, regroupant une 
flute et un hautbois), il y a juste a ajouter une regie : 



<xsl :template match="ver 
<xsl :cal 1 -template r 
</xsl :templ ate> 



eta creer le regroupementd'attributs correspondant : 

<xsl :template name="fl hb"> 

<xsl : attribute name="fl ">xxx</xsl :attribute> 

<xsl attribute name="hb">yyy</xsl :attribute> 
</xsl :templ ate> 

L e programme est done finalement celui-ci : 

plagesCD.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 



<xsl :templ ate name="bc"> 

<xsl: attribute name="vdg">cplu</xsl :attribute> 
<xsl attribute name="cl v">nspt</xsl :attribute> 
<xsl attribute name="thb">eblq</xsl :attribute> 

</xsl :template> 

<xsl rtemplate name="vls"> 

<xsl: attribute name="vll">fmrt</xsl :attribute> 
<xsl attribute name="vl2">oded</xsl :attribute> 

</xsl :template> 

<xsl rtemplate name="tt"> 

<xsl :call-template name="bc"/> 

<xsl : call -tempi ate name="vls"/> 

<xsl attribute name="vcl">dsmp</xsl :attribute> 
</xsl :template> 



<xsl template match="/"> 

<pl ages> 

<xsl :apply-templates/) 

</plages> 
</xsl :template> 
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<plage> 

<xsl :apply-templates se1ect="effectif" /> 
<xsl:value-of select="titre" /> 
</plage> 
</xsl:for-each> 
</xsl :templ ate> 

<xsl :template match="basseContinue"> 

<xsl:call -tempi ate name="bc'7> 
</xsl :template> 

<xsl : tempi ate match="violons"> 

<xsl :cal 1 -tempi ate name="vls"/> 
</xsl :templ ate> 

<xsl :template match="tutti "> 

<xsl:call -tempi ate name="tt'7> 
</xsl :template> 

<xsl :template match 
<xsl :attribute 
</xsl :templ ate> 

<xsl : tempi ate match="text()"/> 

</xsl: stylesheet) 

Le resultat obtenu est exactement le meme qu'auparavant (voir fichier pi agesCD.xmi a la 
section Exemple, page 307). 

Note 

Ne trouvez-vous pas que ces plages de CD manquent terriblement de numeros ? Cela viendra ... (voirCalcul 
d tin numero d'ordre, page 349). 



Complements 

II y a un certain nombre de regies associees a I 'uti I isati on d'un groupement d'attributs 
par I'instruction xsi :attnbute-set. En effet, ayant compris I 'uti I isation de cette ins- 
truction dansun cadre general, oil tout marchecommesurdes roulettes, on en vienttout 
naturel lement a se poser des questions angoissees sur le comportement de X SLT vis a vis 
detel ou tel caslimiteou pathologiquequi pourraittres bien se produire. 

Question 

Soitun element XML en cours d'instanciation dans le document resultat. On suppose que cet element possede 
deja un attributde nom t , etque dans la suite de I'instanciation, on decouvre a nouveau un attributde nom ta 
ajouter a cet element. Est-ce une erreur ? 
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Non, ce n'est pas une erreur. Le dernier ajoute I'emporte. Et c'est meme une technique 
classique pour surcharger un ajout d'attribut : 

|<xsl :when test="@effectif = 'bc-violons' "> 
<plage xsl :use-attribute-sets="bc vls"> 
<xsl attribute name="vl l">xxx</xsl :attribute> 
<xsl :value-of select="titre"/> 
</plage> 
</xsl :when> 

Danscetexemple, on veut que final ement, soit ajoute a l'element<piage> un attributvii 
qui n'ait pas sa valeur « normale », mais la valeur « xxx ». On ajoute done tous les attri- 
buts correspondant a 'bc-vioions', eton ecrase I 'attributvii avec un nouvel attributde 
meme nom, mais ayant une valeur differente. 




Ici la reponse est que I 'ordre d'ajout des attributs est impose par I 'enumeration des noms 
d'attribute-set danslaliste: use-attribute-sets="A b" implique d'abord I'ajout des 
attributs deA, puisceux deB. On est done rameneau cas precedent : encasdeconflitde 
nom, le dernier ajoute ecrase lemalheureux qui etaitdejaau chaud. 

Question 

Quese passe-t-il si on trouve deux attribute-set de meme nom? Est-ce une erreur? 

Non, ce n'est pas une erreur en general. Les deux attribute-set sont tout simplement 
fusionnes, e'est-a-dire que les attributs de I'un sont mis dans I'autre. Du coup on peut 
retomber sur un probleme de conflit de noms d'attribut en effectuant cette fusion. M ais 
cette fois le cas est plus grave, car il peut ne pas y avoir de critere valable pour decider 
lequel I'emporte sur I'autre. Si rien ne permet de trancher, c'est une erreur, maislepro- 
cesseur XSLT n'est pas oblige de la signaler, et peut eventuellement se contenter de se 
baser sur I 'ordre d'apparition des attribute-set dans le document pour determiner un 
vainqueur. 



Mais il peut aussiy avoir un critere, baseparexemplesurla precedence relative d'un attribute-set par rapport a 
I'autre, dans lecasd'une importation par <xsl:import> que Ion verra un peu plus loin (voir Instruction xshimport, 
page 381). 

Vous voyez qu'on est en train de s'enliser dans des problemes a n'en plus finir, qui sont 
dus a ce que les regies sont tres souples et tres « coulantes », ce qui fait que de nombreux 
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problemes surgissent. A chaquefois, s'il y a une solution pour s'en sortir, on I'adopteet 
on en fait une regie. Mais ceci interesse les gens qui doiventecrireun processeurXSLT, 
etbeaucoup moinsceux qui doivents'en servir, parcequ'il estbien raredesemettresoi- 
meme dans de pareilles situations. 

De plus, tous ces problemes disparaissent si on adopte la technique des modeles nommes 
pourfairedesregroupementsd'attributs, au lieu d'utiliserles attribute-set, commeci- 
dessus. D'ou la question : 

Question 

Peut-on prendre le parti d'ignorer completement la notion d'attribute-set, et d'utiliser a la place celle de 
modele nomme regroupantdes attributs ? 

Helas, non. D'abord parcequevouspouvez tombersur des feui lies de style qui utilisent 
les attribute-set ; il faut done comprendre a quoi ils servent et comment ils inter- 
viennent. Ensuite, parcequ'il y aunechosequ'il est i mpossi bledefai re avec les modeles 
nommes, c'estd'importer (par I 'instruction <xsi :import>, que nous verrons plus loin, a 
la section Instruction xshimport, page 381) deux groupements d'attributs provenant de 
deux feui lies de style differentes, de telle sorte que cela se traduise par une fusion des 
deux groupements. (Avec deux modeles nommes importes et de meme nom, au mieux 
I'un des deux sera ignore, et au pi re, il y aura une erreur fatal e : la fusion de modeles 
nommes n'aaucun sens). Or la technique d'importation de feui lies de style est extreme- 
ment importante, car el le permet de modulariser et de reutiliser. 

Ceci n'empeche evidemment pas d'employer la technique des modeles nommes pour 
faire des regroupements d'attributs, qui resteparfaitementvalide en general. Maisil y a 
des cas ou on peut avoir reel I ementbesoin d'utiliser devrais attribute-set. 
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Remarque 

L'instruction xsl : copy n'est pas une instruction de creation comme xsl : el ement ou xsl : attribute, puisque 
c'est une instruction qui permet de recopier un fragment du document source vers le document resultat. Logi- 
quement, il aura it ete preferable de la placer aux cotes de instruction xsl : copy-of , deja vue il y a assez long- 
temps (voir Instruction xsl:copy-of, page 156). E Me se trouve placee ici pour deux raisons. La premiere, c'est 
qu'elle est equivalente dans certains cas a xsl : element, equivalence qui va jusqu'a ('utilisation de I'attribut 
use-attribute-sets, et a xsl : attribute dans certains autres cas (mais il y a aussi des cas oil elle ne 
ressemble ni a I'une, ni a I'autre). 

Ladeuxiemeraisonestquexsl :copy est une instruction bien plus difficile amanierquexsl : copy-of, etqu'il 
auraitete premature de la presenter a la suite de xsl : copy-of : l'instruction xsl :copy estun instrument de 
precision chirurgicale, qui est a xsl : copy-of ce que le bistouri est au marteau-piqueur. 
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Bande-annonce 



Concert.xml 

<?xml versi 



="1.0" encoding="UTF-16" standalc 



<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 



<Ensemble> ' 



deu> 



3S" </Ensemble: 



<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Silvia Abra 
<Instrument>Basse 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Instrument> 
</Interprete> 

<TitreConcert> 

Folies d'Espagne et diminutions d'ltalie 
</TitreConcert> 

<Compositeurs> 

<Compositeur>M. Marais</Compositeur> 
<Compositeur>D. Castel lo</Compositeur> 
<Compositeur>F. Rognoni</Compositeur> 

</Compositeurs> 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl:stylesheet xmlns :xsl="http://www. w3.org/1999/XSL/Transform" version="l.C 



<xsl:output method^'xml' encoding^' ISO-8859-1' indent='yes' /> 



si :template match="/"> 
<Interpretes> 

<xsl -apply-templates/) 
</Interpretes> 
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</xsl :template> 

<xsl :template match="Interprete"> 

<xsl :copy> 

<xsl :apply-templates/> 

</xsl :copy> 
</xsl :template> 

<xsl : tempi ate match="Nom"> 

<xsl:copy> 

<xsl :apply-templates mode="copie"/> 

</xsl :copy> 
</xsl : tempi ate> 

<xsl :template match="Instrument"> 

<xsl:copy> 

<xsl :apply-templates mode="copie"/> 

</xsl :copy> 
</xsl :templ ate> 

<xsl : tempi ate match="text( )"/> 

<xsl :template match="text( )" mode="copie" > 

<xsl:copy/> 
</xsl :templ ate> 

<sl: stylesheet) 



<?xml version="1.0" encoding="IS0-8859-l"?> 

<Interpretes> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

<Interprete> 

<Nom> Silvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 
<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument>Theorbe et Guitare baroque</Ir 
</Interprete> 
</Interpretes> 



L e meme resultat aurait ete obtenu en modifiant legerement le programme comme ceci : 

Concert.xsl 

«?xml version="1.0" encoding="UTF-16"?> 

<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
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<xsl:output method='xml ' encoding^' ISO-8859-1" indent='yes' /> 



<xsl :template match="/"> 

<xsl :apply-templates/> 
</Interpretes> 
</xsl :template> 

<xsl :template match="Interprete"> 

<xsl :copy> 

<xsl :apply-templates/> 

</xsl :copy> 
</xsl :template> 

<xsl :template match="Nom"> 

<xsl:copy> 

<xsl:value-of select=".'7> 

</xsl :copy> 
</xsl :template> 

<xsl :template match=" Instruments 

<xsl :copy> 

<xsl:value-of select=".'7> 

</xsl :copy> 
</xsl :template> 



<xsl :template match="text( )"/> 



</xsl:stylesheet> 



Syntaxe 



L'instruction xsi :copy permet de creer dans le document resultat une copie du nceud 
courant. 

xsi :copy 



<!-- fin du modele de transformation --> 
</xsl :copy> 

L'instruction xsi :copy nedoitpasapparaitreen tantqu'instruction de premier niveau. 



Variante syntaxique 

On peut, si I 'on veut, ajouter un attribut use-attribute-sets, commececi : 
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xsl :copy 

<xsl :copy l 



j modele de tre 



Cet attri but n'est pas toujours pris en compte, cela depend de la nature du nceud courant. 
N ous verrons cela au cas par cas, dans la suite. 

Semantique 

Meme si dans tous les cas, il s'agit d'une copie, I'effet exact de instruction xsi :copy 
depend dela naturedu nceud courant. Les cas les plus frequents d'utilisation sontlacopie 
d'elements ou d'attributs, mais tous les autres types de nceuds (root, text, namespace, 

processing-instruction, comment) peuvent aUSSi etreCOpieS. 

L'instruction xsi :copy peutou noncomporterun modele de transformation ; dans la pra- 
tique, on pourra done trouver cette instruction sous deux formes assez typiques. 
Premiere forme: 

|<xsl:template match=" . . . "> 
<!-- modele de transformation --> 



<!-- fin du modele 
</xsl :template> 

Deuxieme forme: 



<!-- fin du modele de transformation propre a xsl:copy --> 
</Xsl :Copy> 

<!-- fin du modele de transformation --> 
</xsl : tempi ate> 

Enfin, il est assez frequent, dans la pratique, de trouver des emplois recursifs del 'instruc- 
tion xsi: copy ; ce sont des cas oil le modele de transformation propre a xsi:copy 
contient au moins une instruction xsi :appiy-tempiates, et ou le motif de la regie qui 
comporte l'instruction xsi :copy rati ssetres large : lacombinaison decesdeux proprietes 
faitqu'il y a de bonnes chances (en fonction delargeurdu rateau) pour qu'une recursion 
s'amorce. Nous verrons cela dans un autre chapitre (voir Pattern n°10 - Copie non 
conforme, page 443). 



ILes instructions de creation 
Chapitre 6 

Copie d'un nceud de type element 

Sans modele de transformation propre 

L'elementcourant, comme tout element, a un nom : I'effet del 'instruction xsi :copy est 
alorsdecreer un element dememenom, comme si on avait utilise I 'instruction xsi : ele- 
ment pour lecreer. S'il y a des declarations dedomaines nominaux dans l'elementcou- 
rant, elles sont copiees du meme coup ; mais c'est tout, rien d'autre n'est copie, ni les 
eventuels attributs de I 'element courant, ni ses eventuels enfants. 

Voyons cela sur un exemple; nous reprenons le fichier XML obtenu comme resultat 
du programme XSLT montre a la section Exemple avec namespace="...", page 301. 
Ce fichier resultat etait le suivant : 



interventionsRecitant.xml 

<?xml version="1.0" encoding="IS0-8859-l"?) 
<recitant> 
<prologue> 
Le Tableau de 1'Operation de la Taille 
</prologue> 
<mesure xmlns:nsO="http: //concerts. anacr 

L'aspect de 1 'apareil .</mesure> 
<mesure xmlns:nsO="http: //concerts .anacr 

Fremissement en le voyant.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacr 

Resolution pour y monter.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacr 

Parvenu jusqu'au haul t;</mesure> 
<mesure xmlns:nsO="http: //concerts .anacr 

descente dudit apareil .</mesure> 
<mesure xmlns:nsO="http: //concerts. anacr 

Reflexions serieuses .</mesure> 
<mesure xmlns:nsO="http: //concerts. anacr 

Entrelassement des soyes 

Entre les bras et les jambes.</mesL 
<mesure xmlns:nsO="http: //concerts. anacr 

Icy se fait 1 'incision. </mesure> 
<mesure xmlns:nsO="http: //concerts. anacr 

Introduction de la tenette.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacr 



l'( 



tii 



! la pie. 



.</me 



ure> 



<mesure xmlns:nsO="http: //concerts. anacreoi 

Icy Ton perd quasi la voix.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreoi 

Ecoulement du sang.</mesure> 
<mesure xmlns:nsO="http: //concerts. anacreoi 

Icy 1'on oste les soyes. </mesure> 
<mesure xmlns:nsO="http: //concerts. anacreoi 

Icy 1'on vous transporte dans le lit.</mi 
</recitant> 



fr/viole 


-de-gambe" n 


sO:No= 


"1" 


fr/viole 


-de-gambe" n 


sO:No= 


"8" 


fr/viole 


-de-gambe" n 


sO:No= 


"11 


fr/viole 


-de-gambe" n 


sO:No= 


"15 


fr/viole 


-de-gambe" n 


sO:No= 


"20 


fr/viole 


-de-gambe" n 


sO:No= 


"22 


fr/viole 


-de-gambe" n 


sO:No= 


"23 


fr/viole 


-de-gambe" n 


sO:No= 


"27 


fr/viole 


-de-gambe" n 


sO:No= 


"31 


fr/viole 


-de-gambe" n 


sO:No= 


"39 


fr/viole 


-de-gambe" n 


sO:No= 


"44 


fr/viole 


-de-gambe" n 


sO:No= 


"48 


fr/viole 


-de-gambe" n 


sO:No= 


"50 


fr/viole 


-de-gambe" n 


sO:No= 


"53 
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Lecontenu decefichier n'a aucune importance; la seule chose qui compteici, estqu'il 
y a des elements avec une declaration dedomaine nominal, un attri but, etun enfant direct 
(un nceud de type text, en I 'occurrence). 

On va done les copier, etvoircequ'il en resteaprescopie. Le programme XSLT esttres 
simple: 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 



<xsl:output method='xml' indent="yes" encodings' ISO-8 



<xsl :template mc 


tch="/"> 








<mesures> 










<xsl :apply-templates/> 








</mesures> 










</xsl :template> 










<xsl : tempi ate mc 


tch="mesure"> 








<xsl:copy/> 










</xsl : tempi ate> 










<xsl :template mc 


tch="text()"/> 








</xsl:stylesheet> 










Resultat 










<?xml version="1.0" 


encoding="IS0-8859- 


1"?> 






<mesures> 










<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 


<mesure xmlns 


nsC 


="http://concerts.a 


lacreon 


fr/viole 


de-gambe' 



Le resultat confirme bien ce qui etait annonce plus haut: I 'element courant, lors de 
I'instanciation du modele de transformation associe a la regie <xsi :tempiate match= 
"mesure">, donne son nom et ses domaines nominaux a un nouvel element cree dans le 
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document resultat, maisnedonnerien d'autreautomatiquement : I'attribut nsO:No=" . . 
adisparu, etletexteassocieaussi, cequi fait que I'element ainsi cree seretrouve vide. 

Avec modele de transformation propre 

Si I'instruction xsi :copy possede en propre un modele de transformation, tout se passe 
d'abord comme s'il n'y en avait pas. Done, comme explique ci-dessus, il y a creation 
d'un element de meme nom, et de memes domaines nominaux. U ne fois I'element ainsi 
cree, le modele de transformation local est instance, cequi a poureffetdecreerdesnou- 
veaux nceuds (qui peuvent etre de type text, el ement, attri bute, comment, etc.) qui vont 
etre rattaches a I'element precedemment cree. 

On voit done ce qui va se passer : supposons par exemple que le modele de transforma- 
tion comporte seulement un noeud texte, ce dernier va etre instance et attache a son 
parent dans un lien parent-enfant. 

Exemple: 

|<xsl :template match="mesure"> 
<xsl :copy> 
texte sur mesure 
</xsl :copy> 
</xsl :templ ate> 



;?xml version="1.0" encoding="IS0-8859-l"?> 
;mesures> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe"> 

texte sur mesure 
</mesure> 

<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe"> 
texte sur mesure 



Si maintenant le modele de transformation comporte une instruction xsi: attribute, 
comme ceci : 

|<xsl :template match="mesure"> 
<xsl:copy> 
<xsl attribute name="No">23</xsl :attribute> 
</xsl :copy> 
</xsl :template> 

ce sera cette fois un attribut qui sera attache a I'element : 



<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xmlns:nsO="http: //concerts .anacreon.fr/viole-de-gambe" No="23"/> 
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<mesure xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" No="23"/> 
<!-- etc. --> 
</mesures> 

Au fait, on a perdu le domaine nominal de I'attribut "No" dans la bagarre. Comment le 
fairereapparaitre? En realite, cen'estpas un probleme lie a instruction xsi :copy, mais 
axsi attribute. II fautici utiliser la variante syntaxique avec attributnamespace=". . 
(voirVariante syntaxique namespace="...", page 300). 

De plus, il faudra utiliser un descripteur de valeur differee d'attribut, qui est autorisee 
pour cet attribut, et fournir une expression XPath qui soit egale au domaine nominal 
-nsO". Cen'est pas le genre d'expression XPath qu'on manipuletressouvent, il est done 
preferable ici de rappeler qu'on la construit comme une expression donnant un attribut, 

maiS aveC I'axede localisation "namespace::" au lieu de "attribute::". 

<xsl : tempi ate match="mesure"> 

<xsl :copy> 

<xsl attribute name="No" namespace="{namespace: :ns0)">23</xsl :attribute> 

</xsl :Copy> 
</xsl :template> 

Ici, on reclame pour I'attribut No un domaine nominal qui soit le namespace connu sous 
I'abreviation nso. 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<mesure xmlns:nsO="http: //concerts. anacreon.fr/viole-de-gambe" nsO:No="23"/> 
<mesure xmlns:nsO="http: //concerts. anacreon.fr/viole-de-gambe" nsO:No="23"/> 
<!-- etc. --> 
</mesures> 

A titre de curiosite, voici les del ires qu'on auraitobtenussi on avaitomis la notation des 
descripteurs de valeurs differees d'attribut : 

<xsl :template match="mesure"> 

<xsl :copy> 

<xsl :attribute name="No" namespace="namespace: :ns0">23</xsl :attribute> 

</xsl :copy> 
</xsl:template> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" 

xmlns:ns0.6="namespace: :nsO" ns0.6:No="23"/> 
<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" 

xmlns:ns0.6="namespace: :nsO" ns0.6:No="23"/> 
<!-- etc. --> 
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Ou bien si on s'etait dit que le domaine nominal, c'etait « nsO », et qu'on pouvait done 
indiquer directementcettevaleur : 



<xsl :template mat 


ch="mesure"> 






<xsl:copy> 








<xsl:attr 


ibute name="No" namespace="n 


0">23</x 


1 :attribut 


</xsl :copy> 








</xsl :template> 








Resultat 








<?xml version="l 


0" encoding="IS0-8859-l"?> 






<mesures> 








<mesure xmlns 


ns0="http: //concerts. anacreo 


.fr/viol 


-de-gambe" 


xmlns 


ns0.6="ns0" ns0.6:No="23"/> 






<mesure xmlns 


ns0="http: //concerts. anacreo 


.fr/viol 


-de-gambe" 


<!-- etc. --> 


ns0.6="ns0" ns0.6:No="23"/> 







Dans ces deux cas, la valeurfourniedans l'attributnamespace="..." est prise pour une 
chaine de caracteres decrivant un nouveau domaine nominal. Normalement, une telle 
chainea la forme d'une URL (http://etc), mais il n'y aucune verification. Pour que 
cela marche, il faut donner non pas une nouvelle valeur de domaine nominal, mais une 
valeurexistante. 

La valeur exiStante, C'eSt http://concerts.anacreon.fr/viole-de-gambe, C'eSt-a-dire 

la valeur du pseudo-attributxmins:nso, commeon peutlevoiren considerant a nouveau 
I'un des elements <mesure> du document source : 

<mesure xmlns :nsO=" http://concerts.anacreon.fr/viole-de-gambe" 

InsO:No="l"> 
L'aspect de 1 'apareil . 
</mesure> 

Si c'etait un veritable attribut, on le referencerait en ecrivant I'expression XPath 

"attribute: :xmlns:nsO", de meme qU'On eCMrait I'expreSSiOn "attribute: :nsO:No" 

pour referencer la valeur de I 'attri but nso : No. M ais xmi ns : nso n'est pas un attribut, meme 
s'il en a la forme. C'estun domaine nominal, ou namespace, quel'on trouvesur I'axede 

localisation namespace: : et non paS attribute: :. 

Or cette expression XPath "namespace: :xmins:nsO" ne peut pas etre pi acee telle quelle 
comme valeur del'attribut namespace : 

<xsl attribute name="No" namespace="namespace: :xmlns :ns0">23</xsl :attribute> 

Si on ecrit cela, ce n'est pas une expression XPath qui est fournie comme valeur, mais 
une simple chaine de caracteres sans signification particuliere. Pour que cette chaine soit 
reconnue comme une expression XPath aevaluer, il fautenfaireun descripteurde valeur 
differee d'attri but, comme ceci : 

<xsl attribute name="No" namespace="{namespace: :xmlns:ns0}>23</xsl :attribute> 
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Etcettefois, c'estbon ! 

Supposons maintenant qu'on veuille aussi copier le nceud text qui se trouve attache a 
chaque element <mesure> ; il suffit d'ajouter un nceud text de meme valeur dans le 
model ede transformation proprea I 'instruction xsi :copy ; ce nceud text seraalors ins- 
tance, et attache a I'element <mesure> nouvellement cree avec un lien parent-enfant : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 



<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1 ' /> 

<xsl : tempi ate match="/"> 

<xsl :apply-templates/> 
</mesures> 
</xsl :template> 

<xsl :template match="mesure"> 
<xsl :copy> 

<xsl attribute name="No" namespace="{namespace: :ns0)">23</xsl :attribute> 
<xsl :val ue-of se1ect="."/> 
</xsl :copy> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 
csl: stylesheet) 



<?xml version="1.0" encoding="IS0-8859-l"?> 

<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No="23"> 

L'aspect de l'apareil .</mesure> 
<mesure xmlns:nsO=" http://concerts.anac reon.fr/viole-de-gambe" nsO:No="23"> 

Fremissement en le voyant .</mesure> 
<!-- etc. --> 
</mesures> 

Et pour finir, si I 'on veut que la valeur de I'attribut ne soit pas toujours "23", mais la vraie 
valeur, il suffit de prelever cette vraie valeur et de la fournir a I'instruction xsi attri- 
bute : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 
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<xsl:output method='xml ' indent="yes" encodings IS0-8E 
<xsl :template match="/"> 



<xsl :apply-templates/> 




</mesures> 




</xsl :template> 




<xsl :template match="mesure"> 




<xsl:copy> 




<xsl attribute name="No" namespace=' 


{namespace 


<xsl :value-of select="attribute: 


:nsO:No"/> 


</xsl:attribute> 




<xsl:value-of select=".'7> 




</xsl :copy> 




</xsl :template> 




<xsl :template match="text( )"/> 




/xsl:stylesheet> 





Malheureusement, si I'on essaiecela, on n'obtientqu'un message d'erreur : 



Error on line 17 of copie.xsl: 

Namespace prefix nsO has not been declared 
Transformation failed: Failed to compile stylesheet. 1 error detected. 

En effet, comme le domaine nominal « nsO » intervenient dans cette feuille de style, il 
doit etre declare. II est impossibledecontourner cette obligation ; si I'on tente dene pas 
mentionnerle domaine nominal, I'expressionXPath neselectionnerien du tout: 



<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Tra 



<xsl:output method='xml ' indent="yes" encodings IS0-8E 

<xsl :template match="/"> 

<xsl :apply-templates/> 
</mesures> 
</xsl :template> 

<xsl :template match="mesure"> 
<xsl:copy> 

<xsl attribute name="No" namespace="{namespace: 

<xsl :value-of select="attribute: :No"/> 
</xsl:attribute> 
<xsl:value-of select="."/> 
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</xsl :copy> 
</xsl :template> 



<xsl : tempi ate match="text( )"/> 
</xsl: stylesheet) 



<?xml version="1.0" encoding="IS0-8859-l"?> 
<mesures> 

<mesure xml ns:nsO=" http:/ /concerts. anacr 

L'aspect de l'apareil .</mesure> 
<mesure xml ns:nsO=" http:/ /concerts. anacr 

Fremissement en le voyant.</mesure> 
<!-- etc. --> 
</mesures> 



i.fr/viole-de-gambe" nsO:No=""> 
i.fr/viole-de-gambe" nsO:No=""> 



La seule solution est done de declarer cedomaine nominal : 



copie.xsl 

<?xml version=": 

<xsl :stylesheet 

xmlns:xsl="http:/A 
xmlns:nsO="http://( 



icoding="UTF-16"?> 



v. w3.org/1999/XSL/Transform" 
icerts.anacreon.fr/viole-de-gambe" 



<xsl:output method='xmr indent="yes" encodings' ISO-8859-1' /> 

<xsl :template match="/"> 
<mesures> 

:apply-templates/> 



</> 



</mesures> 
si :template> 



<xsl :template match="mesure"> 
<xsl:copy> 

<xsl :attribute name="No" namespace="{i 
<xsl :value-of select="attribute: :i 
</xsl: attribute) 
<xsl :val ue-of select="."/> 
</xsl :copy> 
</xsl :templ ate> 

<xsl:template match="text( )"/> 
</xsl:stylesheet> 



<?xml v 



Dn="1.0" encoding="IS0-88! 
lns:nsO="http://concerts.< 
isO:No="l">L'aspect de 1 ', 
isO:No="8">Fremissement ei 



-1"?> 

acreon.fr/viole-de-gambe") 
areil .</mesure> 
le voyant.</mesure> 
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<mesure nsO:No="ll">Resolution pour y monter.</mesure> 
<mesure nsO:No="15">Parvenu jusqu'au haul t;</mesure> 
<mesure nsO:No="20">descente dudit apareil .</mesure> 
<mesure nsO:No="22">Reflexions serieuses.</mesure> 
<!-- etc. --> 
</mesures> 

L ' aspect du resultat. 
Fremissementen levoyant. 
Resolution pour y voir plus clair. 
Reflexions serieuses : pourquoi a-t-il change ? 

Soulagement en comprenant que meme si I 'aspect externe a change par rapport a i 'origi- 
nal , la signification XML reste la meme, puisqu'un domaine nominal, declare dans un 
element, est herite par tous ses descendants. 

Note 

Ce n'est pas le seul cas oil I'aspect du resultat peut ne pas correspondre exactement a ce que I'on attend ; mais 
si la semantique XML estcorrecte, etque la seule chose a changer est I'aspect externe du resultat, ce n'est pas 
certain qu'il soit possible d'y parvenir. Parexemple, si vous n'aimez pas les apostrophes doubles (") pour les 
attributs, etque vous preferez les simples, inutile de chercher, il n'y a aucun moyen de reglerce detail en XSLT. 
Avec di sable-output-escaping (voir section Variante syntaxique, page 260), il est possible d'empecherfdans 
certains cas) la sortie d'entites caracteres, mais si une entite caractere estemise dans le document resultat, 
vous ne pouvez pas choisir, par exemple, entre > et > qui sont considerees comme equivalentes. II est 
vrai que I'esthetique d'un fichier source peut etre d'une certaine importance, au moins pour les personnes sen- 
sibles, etque des versions ulterieures de XSLT permettront peut-etre de mieux prendre en compte les prefe- 
rences de chacun ; mais pour I'instant, quand on n'a pas ce que I'on aime, il faut aimer ce que I'on a. 

Conclusion 

Lorsque le nceud courant a copier est de type ei ement (et dans ce cas seulement), I'ins- 
truction xsi :copy secomportedonc comme I'instruction xsi : element. Tout ce qui aete 
vu a proposdexshelements' applique done dans ce cas. D'ailleurs, on pourrait tres bien 
recrirele programme copie. xsi dans sa version precedente, en utilisantxsi : element au 
lieu dexsi :copy : 

copie .xsi 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns: xsi ="http: //www. w3.org/1999/XSL/Transform" 

xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe" 

version="1.0"> 

<xsl:output method='xml' indent="yes" encodings ISO-8859-1 ' /> 
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<xsl :apply-templates/> 
</mesures> 
</xsl :template> 

<xsl : tempi ate match="mesure"> 
<xsl:element name="mesure"> 

<xsl :attribute name="No" namespace="{namespace: :nsO}" 

<xsl :value-of select="attribute: :nsO:No"/> 
</xsl: attribute) 
<xsl:value-of select-". "/> 
</xsl: element) 



<xsl : tempi ate match="text( )"/> 
</xsl:stylesheet> 

Le resultat obtenu est strictement identique au precedent. 

Cette equivalence entre xsi :copy et xsi : element lors de la copie d'un nceud de type 
element, permet done de comprendre immediatement comment utiliser I'attribut faculta- 
tif use-attribute-sets : de facon evidente, il s'utilise exactement comme pour I' ins- 
truction xsi element (voir Variante syntaxique use-attribute-sets="...", page 289). Mais 
encore une fois, ceci n'est vrai que si le noeud a copier est un nceud de type ei ement. 

Copie d'un nceud de type attribute 

L'attribut courant, comme tout attribut, a un nom et une valeur : I'effet de I'instruction 
xsi :copy est alors de creer un attribut de meme nom et de meme valeur, comme si on 
avait utilise I 'instruction xsi attribute (associeeau modele de transformation qu'il faut 
pour que ce soit bien la bonne valeur qui soit affectee a I'attribut). Comme la valeur de 
I'attribut n'est pas modifiable par xsi: copy, un modele de transformation propre a 
xsi :copy ne sert ici arien. Ce n'est pas une erreurd'enfournirun, maisil est ignore par 
leprocesseurXSLT. 

Et comme un attribut ne peut pas avoir d 'attribut, I'attribut use-attribute-sets est aussi 
ignore, si jamais il estfourni. 

Lesmemesproblemesdeja rencontres pour xsi attribute surviennentici : si on essaye 
de creer un attribut dans le document resultat, alors que le noeud destinataire n'est pas de 
type element, c'est une erreur fatale. Par contre I'ajout de plusieurs attributs de meme 
nom n'en n'est pas une: c'est le dernier ajoute qui l'emporte(n'oublionspasla regie du 
pape, voir Se'mantique, page 293). 

Pour illustrer ceci, reprenonsl'exempledu fichierXM L decrivantdes plages de CD (voir 
Exemple, page 307), etvoyonsle programme XSLT capable delereprodui re a I 'identique. 
Lefichierde depart est eel ui-ci : 

plagesCD.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<plages> 
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</p 


age> 


<pl 


ge 




Presto 


</p 


age> 



vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
v!2="oded" org="fech"> 



="nspt" thb="eblq" 



Adagio 
</plage> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
v!2="oded" vlc="dsmp" org="fech"> 
Presto Recit de basse 
</plage> 
</plages> 

Et voici le programme de copie : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encoding=' ISO-8859-1 ' /> 

<xsl :template match="/"> 

<plages> 

<xsl :apply-templates/> 

</plages> 
</xsl :template> 

<xsl :template match="plage"> 
<xsl :copy> 

<xsl :for-each select="attribute: :*"> 

<xsl :copy/> 
</xsl:for-each> 
<xsl:value-of select="."/> 
</xsl :copy> 
</xsl :template> 

</xsl:stylesheet> 

Pour chaque <piage> rencontree, on cree un element de meme nom par instruction 
<xsi : copy>, auquel on accroche autant d'attri buts qu'on en trouve dans I 'element origi nal . 
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Explorer I 'ensemble desattributsdecet element original peut sefai re par une instruction 
xsi :for-each qui selectionne tout ce qui est attri but du noeud courant. Le modele de 
transformation dexsi :for-each necontientqu'uneseule instruction, qui va etreinstan- 
ciee avec un noeud courant qui est un attri but. Comme cette instruction est I 'instruction 
xsi :copy, c'est un attri but qui va etre cree avec le meme nom et la meme valeur que 
I 'attri but courant. Ensuite, cet attri but sera ajoute a I 'element courant (une <piage>, en 
I'occurrence). 

Resultat 

<?xml version="1.0" encoding-"IS0-8859-l"?> 
<plages> 

<plage vdg="cplu" clv-"nspt" thb="eblq" vll="fmrt" vl2="oded" 
org="fech">Grave</plage> 

<plage vdg="cplu" clv-"nspt" thb="eblq" vll="fmrt" vl2="oded" 
vcl="dsmp">Presto / Prestissimo</plage> 

<plage vdg="cplu" clv-"nspt" thb="eblq" vll="fmrt" vl2="oded">Adagio</plage> 

<plage vdg="cplu" clv-"nspt" thb="eblq" vll="fmrt" vl2="oded" 
vcl="dsmp" org-"fech">Presto Recit de basse</plage> 

</plages> 

La presentation n'est pas la meme que celledu fichier de depart, maison saitqu'il n'y a 
pas grand chose a faire (voir section Avec module de transformation propre, page 328). 

Une autre facon deproceder, assezclassique, serait celled : 

copie.xsl 

<?xml version-"!.. 0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl: output method='xml ' indent="yes" encoding-' ISO-8859-1" /> 

<xsl : tempi ate match="/"> 

<plages> 

<xsl :apply-templates/> 

</plages> 
</xsl : tempi ate> 

<xsl :template match="plage"> 
<xsl:copy> 

<xsl :apply-templates select="attribute: :*"/> 
<xsl :val ue-of select-". "/> 
</xsl :copy> 
</xsl : tempi ate> 
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|<xsl :template match="attribute: :*"> 
<xsl :copy/> 
</xsl:template> 

</xsl:stylesheet> 

Au lieud'utiliserunxsi :for-each pour expl orer chaque attri but, on relancelemoteurde 
recherche de concordance de motifs en lui faisant traiter une liste de noeuds qui ne 
contient que les noeuds de type attri bute attaches au nceud courant. On ajoute alors une 
regie, dontle motif Concorde avec n'importequel nceud detype attribute : cette regie 
sera done selectionnee par la recherche de concordance dont on vient de parler, et son 
application se traduit par une copie de I 'attri but courant. 

Le resultat est exactement le meme que dans la version precedente. 

Copie dun nceud de type namespace 

Les choses se passent a peu pres comme dans le cas d'un attri but, car e'est vrai qu'un 
domaine nominal est assez semblable a un attri but. Le model e de transformation est 
ignore, s'il existe, de meme que I 'attri but use-attribute-sets. 

Ledomaine nominal courant, comme tout domaine nominal, a un nom (i.e. leprefixe, ou 
abreviation) et une valeur (i.e. une URL) : I'effet de I'instruction xsi :copy est alors de 
creerun domaine nominal de meme nom etde meme valeur. 

Les memesproblemesdeja rencontres pour xsi attribute surviennentici : si on essaye 
de creer un attri but dans le document resultat, alors que le nceud destinataire n'est pas de 
type ei ement, e'est une erreur fatale. 

Attention : la regie du pape nes'appliquepas, ici : e'est une erreur que de vouloir ajou- 
ter un domaine nominal a un element qui en possede deja un de meme nom, sauf si la 
valeur est la meme que eel ledu doublon, auquel cas lenouveau domaine nominal est tout 
simplement ignore. 

La copie de domaines nominaux doit etre terminee avant tout ajout d' attri but ou d'ele- 
ment fils a I 'element parent, sinon, e'est une erreur fatale. 

En consequence, il est impossible de copier un element, puis son domaine nominal : en 
effet, la copie d'un element entraine automatiquement celle de ses domaines nominaux. 
Nous allons done proceder d'une maniere legerement differente, pour ill ustrer la copie de 
domaines nominaux atravers un exemple. 

Nous prendrons le fichier qui nous a deja servi plusieurs fois : 

taille.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<mesures xmlns:nsO=" http://concerts.anacreon.fr/viole-de-gambe"> 

<mesure nsO:No="l">L'aspect de 1 'apareil .</mesure> 

<mesure nsO:No="8">Fremissement en le voyant.</mesure> 

<!-- etc. --> 
</mesures> 
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Voici un programme de copie : 



copie.xsl 






<?xml version="1.0" encoding="UTF-16"?> 






<xsl: stylesheet 






xmlns:xsl="http: //www. w3.org/1999/XSL/Tr 
version="1.0"> 


ansform' 




<xsl:output method='xml' indent="yes" e 


needing^ 


'ISO 


<xsl : tempi ate match="/"> 






<paroles> 






<xsl:for-each select="child: :mes 


ures/nam 


espa 


<xsl:copy/> 






</xsl:for-each> 






</paroles> 






</xsl :templ ate> 






</xsl:stylesheet> 






Resultat 






<?xml version="1.0" encoding="IS0-8859-l"?> 






<pa roles xmlns:nsO="http: //concerts. anacreon 


.fr/viol 


e-de 



le-de-gambe"/> 

lei la copie creeun domaine nominal denom nsoetdevaleur : 

http://concerts.anacreon.fr/viole-de-gambe 

puisque le nceud courant est un domaine nominal, grace au xsi :for-each. Ce domaine 
nominal estajouteal'element<paroies>, c'est-a-dire celui qui est en coursde creation. 

Copie du nceud de type root 

Si le noeud courant lors de I'execution de I 'instruction xsi :copy est le noeud root, le 
model ede transformation associeaxsi :copy, s'il y en a un, est instancie. Mais la racine 
n'est pas copiee, parcequela racine de I 'arbreXML du resultat est toujours creee auto- 
matiquement, au debut du traitement, et qu'il ne s'agirait pas d'en creer une deuxieme. 
Un eventuel attri but use-attribute-sets estbien sflr ignore. 

Prenons par exemple le programme X SLT suivant : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1" /> 

|<xsl :template match="/"> 
<xsl :copy> 
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</xsl :Copy> 
</xsl :template> 
</xsl:stylesheet> 

Quel que soit le fichier XML donne, le resultat est le suivant : 
Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 



On voit bien qu'effectivement I 'instruction xsi :copy en elle-meme est inutile, et qu'on 
auraitpu negarder que lemodelede transformation associe, cequi aurait donne lememe 
resultat. 

Copie d'un nceud de type text 

Letexte est copie dans le document resultat. Lemodelede transformation dexsi :copy 
est ignore, ainsi que I'attri but use-attribute-sets. 

Copie d'un nceud de type comment 

Le commentaire est copie dans le document resultat. Le modele de transformation de 

xsl :copy est ignore, ainsi que I'attri but use-attribute-sets. 

Copie d'un nceud de type processing-instruction 

La processing-instruction est copiee dans le document resultat. Lemodelede transforma- 
tion dexsi :copy est ignore, ainsi que I'attri but use-attribute-sets. 

Instruction xshcomment 

Syntaxe 

L'instruction xsi: comment permet de creer un commentaire XML dans le document 
resultat. 



L'instruction xsi comment ne doit pas apparaitre en tant qu'instruction de premier niveau. 



Instruction xshcomment 



Semantique 



L'instanciation du modele de transformation de ^instruction xsi : comment ne doit pas 
creer autre chose que des nceuds de type text ; sinon c'est une erreur. C'est aussi une 
erreur que ces nceuds textes contiennent des sequences de caracteres interdites dans un 
commentaireXML (comme par exemple la sequence "--"). 

II est bien sflr impossible de creer un commentairedans le document resultatautrement 
que par ^instruction xsi comment ; la presence d'un commentaire dans un element 
source litteral est notamment sans effet sur le resultat, puisqu'un tel commentaire est 
ignore par le processeur X SLT. 

Exemple 

Une utilisation interessante des commentaires XML generes par un programme XSLT 
est de tracer I'activation des regies du programme lorsqu'il y a un probleme, pour en 
comprendrel'origine. Pour voircequeceladonne, nous reprenonsle programme vu a la 
section Exemple, page 170, en placant une instruction xsi :comment dans chaque regie: 

Concert.xsl 

|<?xml version="1.0" encoding="UTF-16"?> 
<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 
<xsl:output method="html' encodings' ISO-8859-1' /> 

<xsl : st rip- space el ements=' Compositeurs' /> 

<xsl :template match="/"> 
<html> 
<head> 

<title><xsl:value-of select="/Concert/Entete"/X/title> 
</head> 
<body bgcolor="white" text="bl ack"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :template> 

<xsl :template match="Entete"> 

<xsl :comment> 

<xsl:text>dans Entete : </xsl :text><xsl :val ue-of select="."/> 

</xsl :comment> 

<p> <xsl :value-of select="."/> presentent </p> 
</xsl :template> 

<xsl :template match="Date"> 
<xsl :comment> 

<xsl :text>dans Date : </xsl :text><xsl :val ue-of select="."/> 
</xsl :comment> 
<H1 align="center"> Concert du <xsl :val ue-of select="."/> </Hl> 
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<xsl :template match="Lieu"> 




<xsl :comment> 




<xsl :text>dans Lieu : </xsl :text><xsl : 


/alue-of select 


</xsl :comment> 




<H4 al ign="center"> <xsl :value-of select=" 


"/> </H4> 


</xsl :template> 




<xsl :template match="Ensemble"> 




<xsl :comment> 




<xsl:text>dans Ensemble : </xsl:text>< 


*sl:value-of se 


</xsl :comment> 




<H2 align="center"> Ensemble <xsl :val ue-of 


select=".'7></ 


</xsl :template> 





<xsl :templ ate match="Compositeurs"> 

<xsl :comment> 

<xsl :text>dans Compositeurs : </xsl :text><xsl :val ue-of select=". 

</xsl :comment> 

<H3 align="center"> Oeuvres de <br/> <xsl :apply-templ ates/> </H3> 
</xsl :template> 

<xsl :template match="Compositeur"> 
<xsl :comment> 

<xsl :text>dans Compositeur : </xsl :text><xsl :val ue-of select="." 
</xsl :comment> 

<xsl:value-of select="."/> 

<xsl:if test="not(position() = last())">, </xsl:if> 
</xsl :template> 

<xsl :template match="text( )"/> 

</xsl:stylesheet> 

Leresultatobtenu est celui-ci : 

Concert.html 

<html> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-l 

<title> Les Concerts d'Anacréon </title> 

</head> 

<body bgcolor="white" text="black"> 

<!--dans Entete : Les Concerts d'Anacreon --> 

<p> Les Concerts d'Anacréon présentent </p> 

<!--dans Date : Jeudi 17 Janvier 2002, 20H30--> 

<H1 align="center"> Concert du Jeudi 17 Janvier 2002, 20H30</H1> 

<!--dans Lieu : Chapelle des Ursules--> 
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ilign="center">Chapelle des Ursules</H4> 
Jans Ensemble : "A deux violes esgales" --> 
ilign="center"> Ensemble «A deux violes esga 
Jans Compositeurs : M. MaraisD. CastelloF. Rognoni- 
il ign="center"> Oeuvres de <br> 
!--dans Compositeur 



<!--d 


ans Compositeu 


<!--d 


ans Compositeu 


</H3> 




</body> 
tml> 





D. Cast 



llo-->D. Castell 
n i - - > F . Rognoni 



Instruction xshprocessing-instruction 

Syntaxe 



L'instruction xsl :processing-in 

XML dans I e document resultat. 



xsl :processing-instruction 



i permet de creer une processing-instruction 



<!-- fin du modele de tra 
</xsl rprocessing-instruction) 

L'instruction xsl :processing-i 

de premier niveau. 



•uction nedoitpasapparaitreen tantqu' instruction 



Semantique 



L'instanciation du modele de transformation de instruction xsi :processing-instruc- 
tion ne doit pas creer autre chose que des noeuds de type text ; sinon c'est une erreur. 
C'est aussi une erreur que ces noeuds textes contiennent des sequences de caracteres 
interdites dans une processing-instruction XML (comme par exemple la sequence 



Les processing-instructions ne sont pas tres utilisees en X M L, aussi n'est-il pas facile de 
donner un exemple facilement testable. La processing-instruction la plus courante 
reste cellequi s'adresseaun navigateurpourlui indiquer la feuille de style a utiliser pour 
afficher le fichier XML recu. 

Une autre utilisation, plus originale, et qui peut donner des idees, est celle qui en faite 
dans X M etal (www.softquad.com/), un editeur de fichiers sources XML. Ayant declare une 
DTD pour le fichier a editer, X M etal propose defacon contextuelle une palette debalises 
possibles a inserer la ou se trouve place le curseur. Avec une DTD comme celle de doc- 
book, par exemple, on peutvouloir inserer a tel endroitun nouveau <para>, qui est I'ele- 
ment representant un paragraphe. 
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Docbook (http://docbook.org/) est une DTD associee a des feuilles de style XS LT pour rediger des articles, des 
livres, et plus generalement de la documentation. Les feuilles de style XSLT produisent du HTML ou du FO 
(lequel donne du PS ou du PDF avec des processeurs FO adequats). 

X M etal reagit alors en creant non pas un element <para> vide, comme ceci : 

maisen creant un element contenant une processing-instruction : 

<para><?xm- replace- text (para}?X/para> 

La difference est qu'un element videapparait comme tout autre element, alors qu'un ele- 
ment COntenant la processing-instruction <?xm-repl ace-text (para}?> apparait 

avec letexte{para} en blanc surfond noir, cequi lerend particulierement visible. 

Rien n'empecherait done d'imaginer la production, par une feuille de style XSLT, d'un 
flchier XML qui serait incomplet, mais a completer a la main sous X Metal, les zones a 
rempliretantmisesen evidence par des balises <?xm-repi ace-text tpara}?>. 

L'instruction X SLT pour generer une telle balise serait la suivante : 

|<xsl :processing-instruction name="xm-replace-text"> 
<xsl:text> {para}</xsl:text> 
</xsl : process! ng-instruction> 

Instruction xslmumber 

L'instruction xsi : number est une instruction dont I'instanciation produit un numero. En 
ce sens, e'est une instruction de creation, puisqu'on peut supposer que ce numero 
n'existepasen tantquetel dans la source XML. Maisc'estvrai aussi ques'il n'y a pas 
de source XML, il n'y a rien a numeroter; ets'il n'y a rien anumeroter, il n'y a pasde 
numero. On peutdonccontesterajustetitrequexsi number soit une instruction de crea- 
tion aproprementparler. 

Bande-annonce 

Concert.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 

<maison id="l"> 
<RDC> 

<cuisine surface='12m2'> 

Evier inox. Mobil ier encastre. 
</cuisine> 
<WC> 
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Lavabo. Cumulus 200L. 
</WC> 
<sejour surface='40m2'> 

Cheminee en pierre. Poutres au plafond. 

Carrelage terre cuite. Grande baie vitree. 
</sejour> 
<bureau surface=' 15m2'> 

Bibliotheque encastree. 
</bureau> 

</RDC> 
<etage> 

<terrasse>Palmier en zinc figurant le desert. </terrs 
<chambre surface='28m2' fenetre='3'> 
Carrelage terre cuite poncee. 
<alcove surface='8m2' fenetre='l'> 

</alcove> 
</chambre> 
<chambre surface='18m2'> 

</chambre> 

<salleDeBains surface='15m2'> 
Douche, baignoire, lavabo. 
</salleDeBains> 
</etage> 
</maison> 
<maison id="2"> 
<RDC> 



</cuisine> 

</RDC> 
<etage> 

<terrasse> 



<salleDeBains s 


urface='15m2 


Douche. 




</salleDeBains> 




</etage> 




ison > 




<RDC> 




<sejour surface 


='40m2'> 


paillasson 


a 1 'entree 


</sejour> 




</RDC> 




<etage> 




<chambre surfac 


e='18m2'> 



Les instructions de creation 



porte cc 
</chambre> 
</etage> 
</maison> 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" vers 

<xsl:output method='xml ' encoding=' ISO-8859-1' indent='yes' /> 

<xsl :template match="*"> 

<xsl : element name="{ local -name( . )}"> 
<xsl :attribute name="numero"> 

<xsl:number count="*" level="multiple"/> 
</xsl: attribute) 
<xsl :apply-templates/> 
</xsl :element> 
</xsl :template> 

<xsl :template match="text( )"/> 

</xsl: stylesheet) 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<maisons numero="l"> 
<maison numero="l.l"> 
<RDC numero="l.l.l"> 

<cuisine numero="l.l .l.l"/> 
<WC numero="1.1.1.2"/> 
<sejour numero="1.1.1.3"/> 
<bureau numero="1.1.1.4"/> 
<garage numero="1.1.1.5"/> 
</RDC> 
<etage numero="1.1.2"> 

<terrasse numero="l. 1.2. l"/> 
<chambre numero="l.l .2.2"> 

<alcove numero="l .1.2.2. l"/> 
</chambre> 

<chambre numero="l.l .2.3"/> 
<salleDeBains numero="1.1.2.4"/> 
</etage> 
</maison> 

<maison numero="1.2"> 
<RDC numero="1.2.1"> 

<cuisine numero="1.2.1.1"/> 
<garage numero="1.2. 1.2"/> 
</RDC> 
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<etage numero="l .2.2"> 

<terrasse numero="1.2.2.1"/> 
<salleDeBains numero="1.2.2.2'7> 
</etage> 
</maison> 

<maison numero="1.3"> 
<RDC numero="1.3.1"> 

<sejour numero="1.3.1.1'7> 
</RDC> 
<etage numero="1.3.2"> 

<chambre numero="1.3.2.r7> 
</etage> 
</maison> 

Variante 

<xsl:number count="*" level="any"/> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 

<maison numero="2"> 
<RDC numero="3"> 

<cuisine numero="4'7> 

<WC numero="5'7> 

<sejour numero="6"/> 

<bureau numero="7"/> 

<garage numero="8'7> 
</RDC> 
<etage numero="9"> 

<terrasse numero="10"/> 

<chambre numero="H"> 
<alcove numero="12"/> 

</chambre> 

<chambre numero="13'7> 

<salleDeBains numero="14"/> 
</etage> 
</maison> 

<maison numero="15"> 
<RDC numero="16"> 

<cin'sine numero="17'7> 

</RDC> 

<etage numero="19"> 

<terrasse numero="20"/> 
<salleDeBains numero="21"/> 
</etage> 
</maison> 

<maison numero= M 22"> 
<RDC numero="23"> 
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<sejour numero="24'7> 
</RDC> 
<etage numero="25"> 

<chambre numero="26"/> 
</etage> 
</maison> 



Variante 

<xsl :number count="*' 



<?xml version="1.0" encoding="IS0-8859-l"? 
<maisons numero="l"> 
<maison numero="l"> 
<RDC numero="l"> 

<WC numero="2'7> 

<sejour numero="3'7> 

<bureau numero="4"/> 

<garage numero="5'7> 
</RDC> 
<etage numero="2"> 

<terrasse numero="l"/> 

<chambre numero="2"> 
<alcove numero="l"/> 

</chambre> 

<chambre numero="3'7> 

<salleDeBains numero="4"/> 
</etage> 
</maison> 

<maison numero="2"> 
<RDC numero="l"> 

<cuisine numero="l'7> 

<garage numero="2'7> 
</RDC> 
<etage numero="2"> 

<terrasse numero="l"/> 

<salleDeBains numero="2'7> 
</etage> 
</maison> 

<RDC numero="l"> 

<sejour num6ro="l"/> 
</RDC> 
<etage numero="2"> 

<chambre numero="l'7> 
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Syntaxe 



- 'single' (par defai 

- motif XPath --> 

- motif XPath --> 

- expression XPath --> 

- {June chaine de caracteres 

- Ocode langue (en, fr, etc 

- {('alphabetic' ou 'traditi 



my' 



-actere 






letter-value^". . ." 
grouping-separator=". . ." 
grouping-size=" ..." 

Touscesattributssontfacultatifs. 

Les accolades indiquent les attributs pour lesquels un descripteur de valeur differee est 

autorise. 

instruction xsi : number est toujours vide. 

instruction xsi number nedoit pas apparaltre en tant qu'instruction de premier niveau. 



Semantique 

L'instanciation del 'instruction xsi number a deux effetsindependants : 

• Le premier est decalculerun numero d'ordre pour lenceud courant. 
Dans ce cas, I'attribut vai ue doit etre absent . 

• Le deuxieme est de formater un numero, afin de lui donner un aspect de numero : 1, 
3.5, A.l, (iii), V I, etc. 

L'attribut value peut etre absent ; dans ce cas le numero formate est le numero d'ordre 

calcule. 

L'attribut vai ue peut etre present ; dans ce cas le numero formate est la valeur fournie 

par I 'expression X Path, dont le calcul doit amener une valeur qui puisse etre convertie 

en entier. 
L'instruction xsi number permet de compter toutes sortes de nceuds (element, comment, 
text, attribute...), maisdansla pratique il bien rared'avoir a compter autre chose que 
des elements. 

Calcul d'un numero d'ordre 

Prenons par exemple la sequence {X a R ? p p a}. Quel est le numero du dernier element 
de cette sequence ? Tout depend de ce que I'on compte : si I'on compte les lettres, il est 
egal a 6 ; si I'on compte les 'a', il vaut2 ; si I'on compte tout, il vaut7. 

L'attribut count permet de determiner la nature des nceuds qui serontcomptes, etdonc le 
numero qui sera affecte au nceud courant. 
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En I 'absence d'attribut count, cesont lessemblablesdu noeud courantqui sontcomptes. 
Par exemple, si le noeud courant est un noeud de type text, on compte les text ; si le 
noeud courant est un element <tmc>, on compte les <tmc>. 

Si I'attribut count est present, sa valeur est un motif XPath ; pour calculer le numero du 
noeud courant, le processeur XSLT compte le nombre de noeuds situes avant lui, et qui 
concordent avec ce motif. II est vrai que « situes avant » est une formulation assez 
vague; la definition precise depend dela valeur de I'attribut level (d'unemaniere assez 
complexe), et on pourra la consulter (par curiosite) dans le standard XSLT. Neanmoins, 
cette definition precise est plus utilie a un programmeur realisant un processeur XSLT 
qu'aun programmeur realisant une feui lie de style XSLT. Le programmeur XSLT peutse 
contenter de comprendre les trois styles de numerotation sur un exemple, sans avoir a 
connaitrel'algorithmeexactdu calcul des numeros ; nousverrons un peu plus loin (voir 
Differents modes de calcul d'un numero d'ordre, page 352) un tel exemple. 

Attention 

Un point assez important est que le decompte se faittoujours sur un document source XML, c'est-a-dire, en pre- 
cipe, sur le document source XML. II est done possible de lancer le decompte sur un autre document que le 
document source principal, a condition que ce soitun document source, c'est-a-dire un documentobtenu parla 
fonction standard document ), ou par la reference a une variable contenant un TST (Temporary Source Tree). 
En consequence, il est impossible de decompter directement des elements du document resultat, mais cela 
reste possible indirectement. II faut d'abord construire, dans une premiere passe, le resultat ou une partie du 
resultat en tantqueTST lie a une variable. Dans une deuxieme passe, on instancie des <xsi :number> qui vont 
done porter sur les elements de ce TST (arbre d'un document source), ce qui aura pour effet de produire des 
numerotations relatives a I'ordre des elements tels qu'ils apparaitrontdans le document resultat, etnon tel qu'ils 
apparaissentdans le documentsource. Nous en verrons plus loin un exemple (voir Exemple, page 363). 

Exemple 

Reprenons I'exemple vu a la section Copie d'un nceud de type attribute, page 335 ; il 

s'agissait d'il lustrer la recopie d'attributs en partant de la source XML suivante : 



plagesCD.xml 








<?xml version=" 


1.0" encoding="IS0-8859-l"? 






<plages> 








<plage 


vdg="cplu" clv="nspt" thb= 
vl2="oded" org="fech"> 


"eblq" 


vll="fmrt" 


Grave 








</plage> 








<plage 


vdg="cplu" clv="nspt" thb= 
vl2="oded" vlc="dsmp"> 


"eblq" 


vll="fmrt" 


Presto 


/ Prestissimo 






</plage> 








<plage 


vdg="cplu" clv="nspt" thb= 


"eblq" 


vll="fmrt" 
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Ivl2="oded"> 
</plage> 

<plage vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 
vl2="oded" vlc="dsmp" org="fech"> 
Presto Recit de basse 
</plage> 
</plages> 

Le programme X SLT realisant la copie auquel nous etions arrives est celui-ci : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 



<xsl:output method='xml ' indent="yes" encodings' ISO-8859-1' /> 

<xsl : tempi ate match="/"> 

<pl ages> 

<xsl :apply-templates/> 

</plages> 
</xsl : tempi ate> 

<xsl :template match="plage"> 
<xsl:copy> 

<xsl : apply- templates select=" attribute: :*"/> 
<xsl:value-of select-". "/> 
</xsl :copy> 
</xsl : tempi ate> 

<xsl :template match="attribute: :*"> 

<xsl:copy/> 
</xsl :templ ate> 

</xsl: stylesheet) 

Voyons maintenant comment modifier la copie pour ajouter un attribut indiquant le 
numero de plage. C'estextremement simple a faire : il suffit de compter les <piage>, et 
pour chacune, de creer un nouvel attribut contenant la valeur du compteur : 

copie.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='xml' indent="yes" encodings' ISO-8859-1 ' /> 
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<xsl :template match="/"> 

<plages> 

<xsl :apply-templates/> 

</plages> 
</xsl :template> 

<xsl :template match="plage"> 

<xsl :variable name="numero"Xxsl :number/></> 
<plage No="{$numero}"> 

<xsl :apply-templates select="attribute: : 
<xsl:value-of select=".'7> 
</plage> 
</xsl :template> 

<xsl :template match="attribute: :*"> 

<xsl :copy/> 
</xsl :template> 

</xsl: stylesheet) 



<?xml version="1.0" encoding="IS0-8859-l"?> 
<plages> 

<plage No="l" vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 

vl2="oded" org="fech">Grave</plage> 
<plage No="2" thb="eblq" vdg="cplu" clv="nspt" vll="fmrt" 

vl2="oded" vcl="dsmp">Presto / Prestissimo</plage> 
<pl age No="3" vdg="cplu" clv="nspt" thb="eblq" vll="fmrt" 

vl2="oded">Adagio</plage> 
<plage No="4" thb="eblq" vdg="cplu" clv="nspt" vll="fmrt" 

vl2="oded" vcl="dsmp" org="fech">Presto Recit de basse</plage> 

</plages> 

lei, I'instruction xsi :number setrouvedansun model ede transformation ou lenoeud cou- 
rant est necessai rement une <pi age>, et comme on veut j ustement compter I es <pi age>, i I 
n'y a pasbesoin defournir I 'attri but count. 

Differents modes de calcul d'un numero d'ordre 

U ne fois qu'on a determine ce qu'on voulait compter, il y a plusieurs facons de compter : 

on peut compter sequentiellement (comme dans le cas de plages, ci-dessus), ou on peut 

compter en faisant transparaitre la nature arborescente du document XML. C ' est I ' attri - 

but level qui intervientici. 

L e pi us si mpl e est demontrerun document arborescent, et devoir les differentes possibi- 

lites de numerotation de ses elements. 

Nous al Ions done parti rdu document suivant, representant un texte structure en sections, 

sous-sections, paragraphes, notes de bas de page et listings de programmes : 
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canevasdoc.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<article lang="fr"> 
<sectl> 

<titre>A</titre> 

<regle importance="l">RlRlR</regle> 

<sect2> 

<titre>B</titre> 
<para>bbb</para> 
</sect2> 
<sect2> 

<titre>C</titre> 
<sect3> 

<titre>D</titre> 
<para>ddd 

<regle importance="3">R2R2R</regle 
<note>Nt</note>ddd/ 
<note>Nv</note> 
</para> 
</sect3> 
<sect3> 

<titre>E</titre> 
<para>eee 

<note>Nah</note>eee; 
</para> 

<para>e,e,e</para> 
<regle importance="l">R3R3R</regle> 
<programlisting>ay</programlisting> 
<para>e;e;e</para> 
<programl isting>bg</programl isting> 
<para>e!e!e 

<regle importance="2">R4R4R</regle 
<note>Naa</note>(eee) 
<note>Nzz</note>[eee] 
<note>NEE</note>(e,e,e) 
</para> 
</sect3> 
<sect3> 

<titre>F</titre> 

<programl isting>ck</programl isting> 
</sect3> 
</sect2> 
</sectl> 
<sectl> 

<titre>G</titre> 
<sect2> 

<titre>H</titre> 
<para>hhh</para> 
<para>hhh/ 

<note>Nhx</note>hhh; 



Les instructions de creation 



I</sect2> 
</sectl> 
</article> 

Voici maintenant le programme que nous allons utiliser pour numeroter ces divers ele- 
ments; hormis I'instruction xsi number proprement dite, le reste du programme, sans 
etre d'un grand interet, est un peu complique, a cause de la mise en page indentee que 
I'on veut obtenir, mais qui n'est pas du tout typique des problemes que I'on se pose 
d'ordinaireenXSLT : 

sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 



houtput method='text' encodings' ISO-8859-1 " /> 



<xsl :template match="sectl [ sect2 [sect3"> 

<xsl:number count="sectl |sect2 |sect3 |titre | para | 
note | programl isting |regle" 
level="any"/>.<xsl :value-of select="name( )"/> 
<xsl:text> </xsl:text> 
<xsl :apply-templates/> 
</xsl :template> 

<xsl :template match="para"> 

<xsl:number count="sectl |sect2 |sect3 |titre | para | 

note | programl isting |regle" level="any"/> 

<xsl:text>.</xsl:text> 

<xsl :apply-templates mode="inpara"/> 
</xsl :template> 

<xsl :template match="note" mode="inpara"> 

<xsl:number count="sectl |sect2 |sect3 |titre | para | 

note | programl isting |regle" level="any"/> 

<xsl:text>.</xsl:text> 

<xsl :text>texteNote=</xsl :text> 

<xsl:value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :template> 

<xsl :template match="programlisting"> 

<xsl:number count="sectl |sect2 |sect3 | titre [ para | 

note | programl isting |regle" level="any"/> 
<xsl:text>.</xsl:text> 
<xsl :text>texteProgramlisting=</xsl :text> 
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<xsl:value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="titre"> 

<xsl:number count="sectl |sect2 [sect3 [titre |para | 

note | programl i sti ng | regie" level="any"/> 

<xsl :text>.</xsl :text> 

<xsl :text>texteTitre=</xsl :text> 

<xsl:value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :templ ate> 

<xsl : tempi ate match="regle" mode="inpara"> 

<xsl :apply-templates select="."/> 
</xsl :templ ate> 

<xsl :template match="regle"> 

<xsl:number count="sectl |sect2 [sect3 [titre |para | 

note Iprograml isting | regie" level="any"/> 

<xsl :text>.</xsl :text> 

<xsl :text>texteRegle=</xsl :text> 

<xsl:value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :template> 

<xsl :template match="text( )" mode="inpara"> 

<xsl:if test="normalize-space(.)"> 
<xsl :text>textePara=</xsl :text> 

</xsl:if> 

<xsl:value-of select="."/> 

<xsl :text> </xsl :text> 
</xsl :template> 

</xsl:stylesheet> 

Resultat (level=« any ») 

l.sectl 

2.texteTitre=A 

3.texteRegle=RlRlR 

4.sect2 

5.texteTitre=B 

6.textePara=bbb 

7.sect2 

8.texteTitre=C 
9.sect3 

10.texteTitre=D 

ll.textePara=ddd 
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12.texteRegle=R2R2R 
13.texteNote=Nt textePara=ddd/ 
14.texteNote=Nv 

15.sect3 

16.texteTitre=E 
17.textePara=eee 

18.texteNote=Nah textePara=eee; 

19.textePara=e,e,e 

20.texteRegle=R3R3R 

21.texteProgramlisting=ay 

22.textePara=e;e;e 

23.textePrograml i sti ng=bg 

24.textePara=e!e!e 

25.texteRegle=R4R4R 
26.texteNote=Naa textePara=(eee: 
27.texteNote=Nzz textePara=[eee! 
28.texteNote=NEE textePara=(e,e, 

29.sect3 

30.texteTitre=F 
31.texteProgramlisting=ck 

32.sectl 

33.texteTitre=G 
34.sect2 

35.texteTitre=H 
36.textePara=hhh 
37.textePara=hhh/ 

38.texteNote=Nhx textePara=hhh; 

Resultat (leve1=« single ») 

l.sectl 

l.texteTitre=A 

2.texteRegle=RlRlR 

3.sect2 

l.texteTitre=B 

2.textePara=bbb 

4.sect2 

l.texteTitre=C 
2.sect3 

l.texteTitre=D 
2.textePara=ddd 

l.texteRegle=R2R2R 
2.texteNote=Nt textePara=ddd/ 
3.texteNote=Nv 



Instruction xshnumber 



3.sect3 

l.texteTitre=E 
2.textePara=eee 

l.texteNote=Nah textePara=eee; 

3.textePara=e,e,e 

4.texteRegle=R3R3R 

5.textePrograml isting=ay 

6.textePara=e;e;e 

7.textePrograml isting=bg 

8.textePara=e!e!e 

l.texteRegle=R4R4R 
2.texteNote=Naa textePara=(eee) 
3.texteNote=Nzz textePara=[eee] 
4.texteNote=NEE textePara=(e,e,e) 

4.sect3 

l.texteTitre=F 
2.textePrograml isting=ck 

2.sectl 

l.texteTitre=G 
2.sect2 

l.texteTitre=H 
2.textePara=hhh 
3.textePara=hhh/ 

l.texteNote=Nhx textePara=hhh; 

Resultat (level=« multiple ») 

l.sectl 

l.l.texteTitre=A 

1.2.texteRegle=RlRlR 

1.3.sect2 

l.3.l.texteT1tre=B 

1.3.2.textePara=bbb 

1.4.sect2 

1.4.1.texteTitre=C 
1.4.2.sect3 

1.4.2.1.texteTitre=D 
1.4.2.2.textePara=ddd 

1.4.2.2.1.texteRegle=R2R2R 
1.4.2.2.2.texteNote=Nt textePara=ddc 
1.4.2.2.3.texteNote=Nv 

1.4.3.sect3 

1.4.3.1.texteTitre=E 
1.4.3.2.textePara=eee 

1.4.3.2.1.texteNote=Nah textePara=ee 
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4.3.3.textePara=e,e,e 

4.3.4.texteRegle=R3R3R 

4.3.5.texteProgramlisting=ay 

4.3.6.textePara=e;e;e 

4.3.7.texteProgramlisting=bg 

4.3.8.textePara=e!e!e 

1.4.3.8. l.texteRegle=R4R4R 
1.4.3.8.2.texteNote=Naa textePara=(eee) 
1.4.3.8.3.texteNote=Nzz textePara=[eee] 
1.4.3.8.4.texteNote=NEE textePara=(e,e,e: 



1.4.4. sect3 

1.4.4.1.texteTitre=F 
1.4.4.2.texteProgramlisting=ck 



2.sectl 

2.1.texteTitre=G 
2.2.sect2 

2.2.1.texteTitre=H 

2.2.2.textePara=hhh 

2.2.3.textePara=hhh/ 

2.2.3.1.texteNote=Nhx textePara=hhh; 

Exemple : numerotation classique pour un livre 

Nous reprenons le meme exemple, mais nous voulons avoir une numerotation classique 
pourun livre : numerotation hierarchique pour les sections, leresten'etantpasnumerote, 
sauf les notes de bas de pages qui ont une numerotation sequent] elle non hierarchique. 

sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl :template match="sectl | sect2 |sect3"> 

<xsl:number count="sectl | sect2 |sect3" 

level="multiple"/>.<xsl:value-of select="name( )"/> 

<xsl :text> </xsl :text> 

<xsl :apply-templates/> 
</xsl :template> 

<xsl :template match="para"> 

<xsl :apply-templates mode="inpara"/> 
</xsl :template> 

<xsl :templ ate match="note" mode="inpara"> 
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<xsl: number count="note" level="any"/> 
<xsl:text>.</xsl:text> 
<xsl :text>texteNote=</xsl :text> 
<xsl:value-of select="."/> 
<xsl:text> </xsl:text> 
</xsl :template> 

<xsl : tempi ate match="programl i sti ng"> 

<xsl :text>textePrograml isting=</xsl :text> 
<xsl:value-of select-". "/> 
<xsl:text> </xsl:text> 

</xsl :template> 

<xsl :template match="titre"> 

<xsl :text>texteTitre=</xsl :text> 
<xsl:value-of select=" ."/> 
<xsl:text> </xsl:text> 

</xsl :template> 

<xsl :template match="regle" mode="inpara"> 

<xsl : apply- templates select=" . "/> 
</xsl :templ ate> 

<xsl :template match="regle"> 

<xsl :text>texteRegle=</xsl :text> 
<xsl:value-of select="."/> 
<xsl:text> </xsl:text> 

</xsl :template> 

<xsl :template match="text( )" mode="inpara"> 
<xsl:if test="normalize-space(.)"> 
<xsl :text>textePara=</xsl :text> 
</xsl:if> 

<xsl:value-of select="."/> 
<xsl:text> </xsl:text> 
</xsl :template> 
<sl:stylesheet> 



Nousavons reduitla porteedu decompte: I'attribut count nementionne plus que les ele- 
ments secti, sect2etsect3 ; de plus nous avons enleve I 'instruction xsi : number des ele- 
ments que nous ne voulons plus compter. Pour les notes de bas de page, nous avons utilise 
lavaleur "any" de I'attribut level arind'avoirunenumerotation lineaire. Void leresultat: 



Resultat 



texteTitre=A 

texteRegle=RlRlR 

l.l.sectz 

texteTitre=B 
textePara=bbb 
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1.2.sect2 

texteTitre=C 
1.2.1.sect3 

texteTitre=D 
textePara=ddd 

texteRegle=R2R2R 
l.texteNote=Nt textePara=ddd/ 
2.texteNote=Nv 

1.2.2.sect3 

texteTitre=E 
textePara=eee 

3.texteNote=Nah textePara=eee; 

textePara=e,e,e 
texteRegle=R3R3R 
texteProgramli stingray 
textePara=e;e;e 
textePrograml isting=bg 
textePara=e!e!e 

texteRegle=R4R4R 

4.texteNote=Naa textePara=(eee) 

5.texteNote=Nzz textePara=[eee] 

6.texteNote=NEE textePara=(e,e,e) 

1.2.3.sect3 

texteTitre=F 
textePrograml i sti ng=ck 

Z.sectl 

texteTitre=G 
2.1.sect2 

texteTitre=H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara=hhh; 

Reinitialisation d'un numero d'ordre 

Un autre problemeest la reinitialisation du numero calcule. Par exemple, il peutarriver, 
pour un livre, que Ton veuille reinitialiser la numerotation des notes de bas de pages a 
chaque nouveau chapitre. 

C'estl'attribut from qui permetcela : sa valeur est un motif X Path, eta chaque fois que 
lenceud courant concorde avec ce motif, la numerotation est reinitialisee. 

Exemple 

Nous reprenons le meme exemple, mais nous supposons que la numerotation des notes 

doit etre reinitialisee pour chaque section3 : 
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sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl: stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 



1: output method='text' encodings ISO-8 



level="multiple"/>.<xsl:value-of select="nan 
<xsl :text> </xsl :text> 
<xsl :apply-templates/> 
</xsl :templ ate> 

<xsl : tempi ate match="para"> 

<xsl :apply-templates mode="inpara"/> 
</xsl : tempi ate> 

<xsl :template match="note" mode="inpara"> 

<xsl:number count="note" from="sect3" level="any"/> 

<xsl:text>.</xsl:text> 

<xsl :text>texteNote=</xsl :text> 

<xsl:value-of select="."/> 

<xsl :text> </xsl :text> 
</xsl :template> 

<xsl :template match="programl isting"> 

<xsl :text>textePrograml isting=</xsl :text> 
<xsl:value-of select="."/> 
<xsl:text> </xsl:text> 

</xsl :template> 

<xsl template match="titre"> 

<xsl :text>texteTitre=</xsl :text> 

<xsl:value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :template> 

<xsl :template match="regle" mode="inpara"> 

<xsl : apply- templates select=" . "/> 
</xsl :templ ate> 

<xsl : tempi ate match="regle"> 

<xsl :text>texteRegle=</xsl :text> 
<xsl:value-of select="."/> 
<xsl:text> </xsl:text> 

</xsl :templ ate> 

<xsl :template match="text( )" mode="inpara"> 
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<xsl :if test="normalize-space(.)"> 
<xsl :text>textePara=</xsl :text> 
</xsl:if> 

<xsl:value-of select="."/> 
<xs1:text> </xsl:text> 
</xsl :template> 
</xsl:stylesheet> 

Resultat (from=« sect3 » pour les notes) 

l.sectl 

texteTitre=A 

texteRegle=RlRlR 

l.l.sectZ 

texteTitre=B 
textePara=bbb 

1.2.sect2 

texteTitre=C 
1.2.1.sect3 

texteTitre=D 
textePara=ddd 

texteRegle=R2R2R 
l.texteNote=Nt textePara=ddd/ 
2.texteNote=Nv 

1.2.2.sect3 

texteTitre=E 
textePara=eee 

l.texteNote=Nah textePara=eee; 

textePara=e,e.e 

texteRegle=R3R3R 

textePrograml i stingray 

textePara=e;e;e 

textePrograml isting^bg 

textePara=e!e!e 

texteRegle=R4R4R 
2.texteNote=Naa textePara=(eee) 
3.texteNote=Nzz textePara=[eee] 
4.texteNote=NEE textePara=(e,e,e) 

1.2.3.sect3 

texteTitre=F 
textePrograml isting^ck 

Z.sectl 

texteTitre=G 
2.1.sect2 

texteTitre=H 

textePara=hhh 
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textePara=hhh/ 

l.texteNote=Nhx textePara=hhh; 

Numero d'ordre sans decompte 

L'attribut vaiue="...", lorsqu'il est present, permet de fournir soi-meme la valeur du 
numero a instancier. Cela peut notamment servir lorsque I'ordre des elements dans le 
document resultat n'est pas I e meme que dans la source X M L . Dans ce cas on peut consti- 
tuerun node-set, puis uti User la fonction posuiono pour renseigner l'attribut value. 

Exemple 

Nous reprenons le meme exemple, mais nous supposons maintenant que nous voulons 
indiquer un recapitulatif des regies importantesa la fin du document. On peut fai re cela 
tresfacilement : 



sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transforn 
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<xsl : tempi ate match="/"> 

<xsl :apply-templates/> 

<xsl :text>Regles importantes : 
</xsl:text> 

<xsl :apply-templates select="//regle" mode="recap"/> 
</xsl :template> 

<!-- etc. --> 

<xsl : tempi ate match="regle" mode="inpara"> 

<xsl : apply- templates select=" . "/> 
</xsl: template) 

<xsl :template match="regle"> 

<xsl :text>texteRegle=</xsl :text> 

<xsl:value-of select="."/> 

<xsl :text> </xsl :text> 
</xsl :template> 

<xsl :template match="regle" mode="recap"> 

<xsl:number val ue="position( )"/>. <xsl :value-of select=" 

<xsl :text> 
</xsl:text> 

</xsl :template> 
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I: tempi ate match="text( )" mode="inparc 

<xsl :if test=" norma lize-space(.)"> 
<xsl :text>textePara=</xsl :text> 

</xsl:if> 

<xsl:value-of select="."/> 

<xsl:text> </xsl:text> 
;1 :template> 



</xsl: 


stylesheet> 


Resultat 




<! 


-- etc. --> 


2. 


sectl 




texteTitre=G 




2.1.sect2 




texteTitre=H 




textePara=hhh 




textePara=hhh/ 




7.texteNote=Nhx textePa 


Regies 


importantes : 


1. 


R1R1R 


2. 


R2R2R 


3. 


R3R3R 


4. 


R4R4R 



La ou on voulait en venir, c'est qu'on aimerait de plus que ces regies soient classees par 
ordre d'importance (attribut importance del 'element <regie>). Du coup, on est dans un 
cas ou I'ordre de ces regies dans le resultat est different de I 'ordre de ces merries regies 
dans le document source. 

On est alors oblige de proceder autrement : une solution (mais ce n'est pas la seule : voir 
Nume'ro d'ordre dans un document source secondaire, page 367) est de constituer un 
node- set contenant les regies triees dans le bon ordre, et fournir nous-memes la numero- 
tati on a I' instruction xsi : number grace a I 'attribut vaiue="..." : 

sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 



<xsl:output method='text' encodings' ISO-8 

<xsl :template match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regles importantes : 
</xsl:text> 

<xsl :for-each select="//regle"> 
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<xsl :sort select="@importance"/> 

<xsl:number value="position()'7>. <xsl :value-of select="."/> 
<xsl:text> 
</xsl:text> 

</xsl:for-each> 
</xsl :templ ate> 



<xsl :template match="sectl | sect2 |sect3"> 
<xsl: number count="sectl | sect2 |sect3" 
level="multiple"/>.<xsl:value 
<xsl :apply-templates/> 

</xsl :templ ate> 

<!-- etc. --> 



</xsl: 


stylesheet> 


Resultat 




<> 


-- etc. --> 


2. 


sectl 




texteTitre=G 




Z.l.sectZ 




texteTit 




textePar 




textePar 
7.t 


Regies 


importantes : 


1. 


R1R1R 


2. 


R3R3R 


3. 


R4R4R 


4. 


R2R2R 



7.texteNote=Nhx textePar 



Mais peut-etre penserez-vous qu'il n'etait pas necessaire de passer par I'instruction 
xsi number pour obtenir ce resultat. C'est vrai que la numerotation est fournie par la 
valeur renvoyeeparlafonction positiono : alorspourquoi ne pas exploiter cettevaleur 
directementdans une instruction xsi :vaiue-of ? 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 



<xsl:output method='text' encoding^' ISO-8 

<xsl :template match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regles importantes : 
</xsl:text> 

<xsl :for-each select="//regle"> 
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<xsl :sort select="@importance'7> 
<xsl :value-of select="position( )"/>. 
<xsl:text> 
</xsl:text> 

</xsl :for-each> 
</xsl :template> 



</xsl:stylesheet> 

De fait, ceci fonctionne aussi bien. M ais, en anticipant sur une prochaine section (voir 
Rendu de la nunv'rotation, page 368), on peut tres facilement modifier le rendu de la 
numerotation avec xsi:number, alors qu'avec xsi :vaiue-of, il faut tout programmer a 
la main : 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl .-output method='text' encodings' ISO-8859-1' /> 

<xsl :template match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regles importantes : 
</xsl:text> 

<xsl :for-each select="//regle"> 

<xsl :sort select="@importance"/> 

<xsl:number value="position( )" format="I"/>. <xsl :val ue-of 

select="."/> 
<xsl :text> 
</xsl:text> 

</xsl:for-each> 
</xsl :template> 

<!-- etc. --> 
</xsl:stylesheet> 
Resultat 

<!-- etc. --> 

2.sectl 

texteTitre=G 
2.1.sect2 

texteTitre=H 

textePara=hhh 

textePara=hhh/ 

7.texteNote=Nhx textePara=hhh; 
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Regies 


importante 


I. 


R1R1R 


II. 


R3R3R 


III. 


R4R4R 


IV. 


R2R2R 



Numero d'ordre dans un document source secondaire 

Unederniere solution (pour leproblemede la section precedente) consisteraita utiliser 
unTST intermedial re. En effet, on veut numeroter des regies dans I 'ordre oil el I es appa- 
raissent dans le document resultat. M ais on sait qu'il est impossible de numeroter direc- 
tement des elements qui se trouvent ailleurs que dans un document source. II faut done 
commencer, dans une premiere passe, par constituer un document source secondaire 
(un TST, voir Temporary Source Tree, page 192). Dans ce TST, on place les elements 
a numeroter, dans le bon ordre (celui du resultat vise), en utilisant eventuellement 
<xsi:sort>. Dans une deuxieme passe, le TST etant constitue, on s'en sert comme 
source XM L secondaire; deslors une instruction <xsi :number> va porter sur cette source 
X M L , et le decompte se fera par rapport a cette source. 

Exemple 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl: stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="l.l"> <!-- compatibilite Saxon 6.5 --> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 



<xsl : tempi ate match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regles importantes : 
</xsl:text> 

<xsl variable name="lesRegles"> 

<xsl :for-each select="//regle"> 
<xsl:sort select="@importanc 
<xsl:copy-of select="."/> 

</xsl:for-each> 

</xsl:variable> 

<xsl :for-each select="$lesRegles//re 
<xsl :number/>. <xsl :val ue-of sel 
</xsl :text> 



<xsl:temp!ate match="sectl | sect2 |sect3"> 
<xsl:number count="sectl I sect2 Isect3" 
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level="multiple'7>.<xsl:value-of select="name( )"/> 
<xsl :apply-templates/> 
</xsl :template> 



</xsl:stylesheet> 




Resultat 

<!-- etc. --> 




2.sectl 




texteTitre=G 




2.1.sect2 




texteTitre=H 




textePara=hhh 




textePara=hhh/ 




7.texteNote=Nhx 


textePa 


Regies importantes : 




1. R1R1R 




2. R3R3R 




3. R4R4R 




4. R2R2R 





Peut-etre vous demandez vous si I'on pouvait faire I'economie de la deuxieme passe, 
c'est-a-dire du deuxieme <xsi :for-each>, en placant directement instruction 
<xsi :number> dans le premier <xsi :for-each>. La reponse est non, car le decompte se 
fait dans le document source courant, pas dans la liste de nceuds temporal re constitute 
par <xsi :for-each> et reordonnee par <xsi :sort>. 

Le modele de transformation du deuxieme <xsi :for-each> est relatif a un document 
source secondai re, reference par la variable les Regies. Les expressions X Path ou les ins- 
tructions XSLT qui s'y trouvents'appliquentdonc aceTST, etnon au document source 
principal. Les deux passes sont done necessaires. 

Rendu de la numerotation 

Un numero de sequence etantcalculeou simplementfourni, on s'interessemaintenanta 
I'aspect exterieur sous lequel il est instance dans le document resultat. Par exemple un 
numero dont la valeur est 4 peut apparaitre sous les formes equivalentes 4, d, D, 004, IV, 
iv, (iv), 4°, IV-, etc. Toutes ces formes sont instanciables directement par I'instruction 
xsi number, sansqu'il y ait besoin de programmer quoi quecesoit. Cela s'applique bien 
sur au cas plus complique ou le numero est forme de plusieurs nombres, dans le cas 
d'une numerotation hierarchique (ievei="muitipie") : 1.2.1 pourrait etre rendu A.2-a, 
par exemple. 

Le principe est le suivant : on ecrit une chalne de formatage, a peu pres dans le meme 
esprit que cequ'on pourrait faire en C-h+ou en C avec I'instruction printf. Cettechaine 
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Chapitre 6 

contient deux types conformations qui doivent alterner dans un ordre quelconque : la 
ponctuation (i.e. les signes divers tels que ". ,")-( 'etc.) et les caracteres alphanume- 
riques. Ces derniers sont interprets comme des descripteurs de formats de sortie, alors 
que les signes de ponctuation sont pris pour ce qu'ils sont sans i nterpretation particuliere. 

L'i nterpretation des descripteurs de format se fait sur la base des conventions suivantes : 
1 : pourinstancier un numero defacon banale; 
001 : pour instancier un numero en imposant un nombre minimum de chiffres ; 

a : pour instancier un numero sous forme de sequence delettres (a be ... z aaabac ... 
az ... ba ...) ; 

A : meme chose avec des lettres majuscules ; 

i : pour instancier un numero en chiffres romains minuscules ; 

I : pour instancier un numero en chiffres romains majuscules. 
Exemples : 
Numero hierarchique 



rendu : B IV-2.e 

format: 001 a.i.l 
rendu : 002 d.ii.5 

lei, il y a beaucoup de possi bilites et de variantes, notamment en utilisant les attributs 

grouping-separator, grouping-size, lang, et letter-value. On pourra Se reporter au 

standard XSLT 1.0 pour une description de leurs effets respectifs. 

Exemple 

N ous al Ions reprendre le programme X SLT precedent, et I 'adapter pour sorti r une nume- 

rotation classique des sections : 

sequence.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encodings ISO-8859-1' /> 



<xsl :template match="/"> 
<xsl :apply-templates/> 
<xsl :text>Regles importantes : 
tsl :text> 
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<xsl :for-each select='7/regle"> 

<xsl :sort select="@importance"/> 
<xsl:number val ue="position( )" format='I7> 
<xsl:text> </xsl:text> 
<xsl:value-of select=" . "/Xxsl :text> 
</xsl:text> 

</xsl:for-each> 
</xsl :template> 

<xsl :template match="sectl [ sect2 |sect3"> 
<xsl:number count="sectl | sect2 ]sect3" 

level="multiple" format="I-l .a "/> 
<xsl:value-of select="name( )"/> 
<xsl :apply-templates/> 

</xsl :template> 

<xsl :template match="para"> 

<xsl :apply-templates mode="inpara"/> 
</xsl :template> 



<xsl :templ ate match="note" mode="inpara"> 

<xsl:number count="note" level ="any" format="l. "/> 

<xsl :text>texteNote=</xsl :text> 

<xsl:value-of select="."/> 

<xsl:text> </xsl:text> 
</xsl :template> 



<x: 



</; 



1 :template match="programl i sti ng"> 
<xsl :text>textePrograml i sti ng=</xsl :text> 
<xsl:value-of select="."/> 
<xsl :text> </xsl :text> 

si :template> 



<xsl :template match="titre"> 

<xsl :text>texteTitre=</xsl :text> 
<xsl:value-of select="."/> 
<xsl:text> </xsl:text> 

</xsl :template> 



<xs" 



</x 



:template match="regle" mode="inpar 
Cxsl :apply-templates select="."/> 
I :template> 



<xsl :templ ate match="regle"> 

<xsl :text>texteRegle=</xsl :text> 
<xsl:value-of select="."/> 
<xsl :text> </xsl :text> 

</xsl :template> 



<xs" 



:template match="text( )" mode="in[ 
(xsl :if test="normalize-space(.)"; 
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<xsl:value-of se1ect=".°/> 
<xsl :text> </xsl :text> 
</xsl :template> 

</xsl:stylesheet> 

Resultat 

I sectl 
texteTitre=A 
texteRegle=RlRlR 
1-1 sect2 

texteTitre=B 
textePara=bbb 

1-2 sect2 

texteTitre=C 
1-2. a sect3 

texteTitre=D 
textePara=ddd 

texteRegle=R2R2R 
l.texteNote=Nt textePara= 
2.texteNote=Nv 

1-2. b sect3 

texteTitre=E 
textePara=eee 

3.texteNote=Nah textePare 

textePara=e,e,e 
texteRegle=R3R3R 
textePrograml isting=ay 
textePara=e;e;e 
textePrograml isting^bg 
textePara=e!e!e 

texteRegle=R4R4R 
4.texteNote=Naa textePare 
5.texteNote=Nzz textePare 
6.texteNote=NEE textePare 

1-2. c sect3 

texteTitre=F 
textePrograml isting^ck 

II sectl 
texteTitre=G 
II-l sect2 

texteTitre=H 
textePara=hhh 
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Regies importantes : 

I R1R1R 

II R3R3R 

III R4R4R 

IV R2R2R 

II fautnoter que le format etant fourni en tantqu'attribut, les regies general es lexicogra- 
phiques pour un attributXM L s'appliquent : certains caracteres comme "<" ou "&" sont 
interdits, et les espaces blancs sont normalises. Ici, en admettant que I'on veuille une 
tabulationapresleschiffresromainsdelanumerotationdesregles, il neservirait a rien de 
placer cette tabulation en tantquesignedeponctuation dans I e format, car elle serait nor- 
maliseeen espace ordinaire. Cela impliquedonc de placer cette tabulation a I'exterieur, 
dans une instruction xsi :text. 



Decoupage d'une application 

XSLT 



Ce chapitre decrit les outils disponibles en XSLT pour decouper une application en 
plusieurs morceaux, soit pour des raisons de maintenabilite, soit pour des raisons de 
reutil isabi lite. A noterquelegrain desemantiqueXSLT estla regleou lemodelenomme ; 
la reuti lisation consiste done a constituer des bibliotheques de regies ou de model es nom- 
mes, ce qui n'est pas tres different, dans le principe, de la constitution de bibliotheques 
de sous-programmes dans des langagescommeC, Pascal, Cobol, Fortran, etc. 

M ais ca, e'est du genie logiciel qui fleure bon les annees soixante (du xx e siecle), et on 
sait que le resultat n'a pas ete a la hauteur des esperances, et que la notion de biblio- 
theque de fonctions reuti I i sables ne marche que dans des cas tres precis, notamment ceux 
ou les structures de donnees manipulees par ces fonctions sont regulieres et triviales (par 
exemple, une bibliothequede fonctions mathematiquesougraphiques, qui n'utilisentque 
des tableaux). 

Des que les structures manipulees sont complexes et diversifies, la notion de biblio- 
theque de fonctions atteint ses limites, et e'est la que la notion d'objets et de classes 
prend le relais, en permettant de constituer des bibliotheques de classes, qui sont des 
grains semantiques beaucoup plus gros que des fonctions, capables d'encapsuler ces 
fameuses structures de donnees. 

Est-ce a dire que les bibliotheques de regies et de model es nommes reuti I i sables sont 
voues a I'echec, tout comme les bibliotheques de fonctions ? 
Non, car on observera que justement, en XSLT, il n'y a aucune diversity possible en 
matiere de structure de donnees. On peut meme dire qu'a part le TST attache a une va- 
riable, il n'y arien. XSLT est fait pour manipuler des arbres XML, pas pour model iser le 
processus metier d'une fabrique de joints de caoutchouc. 
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Neanmoins XSLT estjeune, tresjeune. On n'a pas encore le recul necessaire pour juger 
du degre effectif de reuti I isabi I ite que I'on peut atteindre avec des bibliotheques de 
regies : done, en attendant que les experiences s'accumulent et qu'une synthese puisse 
etrefaite, on peut parti r avec I 'idee qu'il y a de bonnes chances que celafonctionne. 

Ce chapitre presente les differentes possibility dans ce domaine. 

Instruction xshinclude 
Syntaxe 

xsl :include 

<xsl:include 
href=". . ." 

/> 

L'attribut href nedoit pasetre un descripteur de valeur differee. 
instruction xsl : include doit apparaitrecomme instruction de premier niveau. 



Semantique 



instruction xsl :inciude permet d'incorporer au fichier source XSLT courant les ins- 
tructions X SLT d'un autre fichier source XSLT dontl'URI estfourni par l'attribut href. 

Attention 

Pour beaucoup, ce genre destruction rappelle evidemment assez fortement la directive ^include que I'on 
trouve en C ou en C ++. C'est vrai qu'il y a beaucoup de ressemblance entre xsl : i nci ude et #1 nci ude, puisque 
les deux serventa realiser I'immersion d'un fichier dans le fichier courant, mais il y a une difference essentielle : 
en C ou C ++, la directive #i nci ude est prise en charge par un preprocesseur : or il n'y a pas de preprocesseur 
en X5LT. La consequence, c'estqu'il est possible d'avoirenC ou C++ des inclusions conditionnelles, en combi- 
n ant directives ^include ettfifdef, parexemple, alors que c'est absolument impossible en XSLT, au moins 
directement. Remarquez bien que l'attribut href est un attributordinaire : ecrire un descripteurde valeur differee 
au lieu d'une valeur litterale serait une faute de syntaxe. Inutile done de tenter de fournir une valeur calculee au 
prealable dans une variable. Neanmoins, en cas de necessity on peuttoujours simulerle fonctionnementd'un 
preprocesseur : on se reportera a la section Pattern n ' 15 -G eneration d line feuille de style par une autre feuille 
de style, page 507, pourun exemple mettanten ceuvre cette idee. 

L'URI fourni comme valeur de l'attribut href peutetreun nom absolu de fichier ou une 
URL, maisil peut etre aussi un nom relatif. Dans ce cas, le fichier est cherche dans I e 
repertoi re courant, defini comme etant eel ui qui contient la feuille de style courante(celle 
qui comporte I'instruction xsi :inciude). Voir la notion d'URI de base, URI de base 
(remarque en marge de ce texte), page 640. 
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Processus mis en ceuvre 

Si I'on voulait incorporer soi-meme le contenu de la feuille de style referencee dans la 
feuillede style courante, void cequ'il faudraitfairepour realiser le mem e travail quele 
processeurXSLT : 

• examiner les domaines nominaux declares dans I'instruction xsi stylesheet de la 
feuille referencee, et les reporter dans I'instruction xsi stylesheet de la feuille cou- 
rante ; 

• prelever les instructions xsi : import de la feuille referencee, et les reporter dans la 
feuille courante, en les plagant apres toutes les autres instructions xsi :import qui s'y 
trouventdeja, maisavanttoute autre instruction de premier niveau ; 

• prelever les autres instructions de la feuille referencee, et les reporter dans la feuille 
courante, a la place de I'instruction xsi : include concerned (voir figure 7-1, a la sec- 
tion Processus mis en ceuvre, page 381). 

Dans ce processus, on peut etre amene a incorporer des instructions xsi :inciude ou 
xsi : import, qui toutes I es deux, font reference a des fichiers, identifies par des URI four- 
nis comme valeursde I'attribut href, commun a ces deux instructions. Si ces URI sont 
des chemins relatifs, il peut alors etre necessaire de les modifier en les incorporant, de 
telle sorte qu'ils continuent de referencer les memes fichiers (relativement au repertoire 
de la feuille principale), meme si le repertoire contenant ces fichiers n'est pas le meme 
quecelui contenant la feuille principale. 

Si I'on a incorpore des instructions xsi : -include, il faut bien sur reiterer entierement ce 
processus. 

L' instruction xsi : import sera vue un peu plus loin (voir I nstruction xsi : import, page 381) ; 
la seule chose qui compteici, c'estdesavoir que cette instruction doit etre placeeavant 
toute autre sorte d'instructi on de premier niveau ; c'estcequi expliquequ'il faille prelever 
a part les xsi : import, et les placer au bon endroit pour ne pas contrevenir a cette regie. 



Remarque 

Toutceci montre que le travail realise lors d'l 
comme celle que I'on pourrait realiser par un 
eten I'etatdu fichier reference. 


jn xsi : 1 ncl ude est bien plus complique qu'ur 
appel d'entite externe, et qui se traduirait par ui 


le simple inclusion, 
ie inclusion brutale 



Erreurs possibles 

Une reference circulaire (une feuille qui s'inclut elle-meme, directement ou indirecte- 
ment), estinterdite, comme a I 'habitude. 

Par contre, incluredeux foisla meme feuille n'est pas uneerreur en soi, maispeuteven- 
tuellement induire des erreurs (par exemple, si la feuille incluse deux fois contient une 
regie xsi :tempiate, celle-ci sera done placeedeux fois dans la feuille principale, entrai- 
nantdonc uneambiguite, puisquerien nelesdepartage; mais il estvrai que certains pro- 
cesseurs peuvent prendre I e parti, dans ce cas, de se recuperer en choisissant la derniere). 
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Detoutefacon, incluredeux fois la meme feuille n'est pas pertinent; c'esttoujours une 
faute d'inattention ou de conception, et cela ne devrait jamais etre un but consciemment 
recherche. 

Generalement, definir deux fois la meme chose dans une feuille de style est uneerreur, 
done un xsi :inciude qui amene dans la feuille principale quelque chose qui s'y trouve 
deja est un xsi :inciude errone. M ais il convient de s'interroger ici sur le sens exact de 
cette phrase. Que veut dire en effet « qui s'y trouve deja»? Si la chose est une 
declaration de variable ou demodelenomme, il n'y a pas dedoute possible, c'estlenom 
fourni en attribut qui dit si on a un doublon ou non. 

M ais pour une regie de transformation, e'estbeaucoup plus subtil, etleprocesseur XSLT 
ne peut pas toujours conclure au simple examen statique de la feuille de style, et doit se 
contenterde signaler leconflit, s'il survient a I 'execution. Prenons par exempl el 'element 
B de la figure 7-1, a la section Processus mis en «uvre, page 381 ; si cet element repre- 
sente une regie de transformation avec exactement le meme motif et le meme mode dans 
la feuille principale et dans la feuille incl use, c'estsurqu'il y a doublon. 

Leprobleme, e'estquememesi on el i mi nele doublon B, on n'estpaspourautantal'abri 
d'un conflit. Toujours sur la meme figure (7-1), on peut voir des elements A et D dans la 
feuille resultante apres inclusion. Supposons que ces deux elements soient des regies de 
transformation avec des motifs differents ; meme differents, les deux motifs peuvent tres 
bien concorder simultanement avec un certain nceud. Si ce nceud ne fait jamais I'objet 
d'une recherche de concordance de motif, on passe au travers des mail les du filet. Mais si 
ce nceud esttraite par le processeur, alors immanquablement, celui-ci decouvrira les deux 
regies possibles, et I'ambiguite entre A et D sera alors prouvee. 

Enfin, il faut signaler lecasou B serait une instruction xsi :attribute-set : cette fois, 
meme si I 'attribut name est identique dans les deux cas, il n'y a pas de conflit (sauf en cas 
d'attributsdememenom maisdevaleursdifferentes), car les deux attribute-sets sont 
fusionnes. 

On voit done qu'il n'y a pas de regie simple et generale pour determiner si un xsi : 
include est correct ou non, si cen'estdefairecommesi on ecrivait une seule feuille de 
style reunissant la feuille principale et la feuille a inclure, et de veiller en particulier 
(comme d'habi tude) a ne pas ecri re des regies dont I es motifs ne serai ent pas assez discri - 
minants pour etre mutuellement exclusifs sur certains nceuds. 

Position des instructions xshinclude 

Les instructions xsi : include peuvent etre placees n'importeou dans la feuille de style, 
(pourvu qu'elles apparaissent comme instructions de premier niveau), mais il semble 
preferable, en general, deles placer en tetedu fichier principal. En effet, si par malheur 
i'inclusion d'une feuille amene une regie ou une definition de variable qui existe deja 
dans la feuille principale, soit on obtient un message d'erreur suite a I'apparition d'un 
ambiguite (et dans ce cas on corrige I'erreur), soit le processeur accepte I'ambiguite et la 
resouten activant la derniere regie dans I 'ordrede lecture du document. Dans ce dernier 
cas, il vautmieux que la derniere regie soit cellede la feuille principale, cequi implique 
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que I 'i instruction xsi :inciudefautivenesoitpasplaceeverslafin de la feuille princi pale, 
mais au contraire au debut. 

Interetde I'instruction xshinclude 

L'interet de cette instruction, c'estdepouvoir recuperer (pour les reutiliser) des modeles 
nommes conserves dans des fichiers X SLT, et classes dans des bibliotheques, ou de pou- 
voirfragmenter un programme X SLT monolithiqueen plusieurs morceaux pour en faci- 
liter la lecture et la maintenance. 

Dans ces deux cas, le programme X SLT completestconstitueen incluant dans la feuille 
principale les modules desires, et ensuite, tout se passe comme si les instructions qu'ils 
contiennent avaient ete ecrites directement dans la feuille principale. 

Exemple 

N ous prendrons comme exemple I 'utilisation d'une bibliotheque, par exemple la « X SLT 
Standard Library », qui est une bibliotheque « Open Source », maintenue par Steve Balls 
(voir http://xsltsl.sourceforge.net). On y trouve des collections de modeles nommes dans 
differents domaines : Strings, Dates, Nodes, etc. 

Pour illustrer I'utilisation d'une telle bibliotheque, nous allons reprendre I'exemple 
d'annonces de concerts, vu a la section Exemple, page 223. II s'agitdeproduireun plan- 
ning des concerts, comme ceci : 



Planning 

Semaine 47 : "Le Poeme Harmonique" 

Semaine 3 : "A deux violes esgales" 

Semaine 8 : "Ensemble Baroque de Nice" 

N ous partons d'un fichier X M L qui contient les annonces : 

annonces.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 

<Annonces> 

<Entete> "Les Concerts d'Anacreon" </Entete> 
<Annonce> 
<Date> 

<Jour id="mar"/> 
<Quantieme>20</Quantieme> 
<Mois id="nov"/> 
<Annee>200K/Annee> 
<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Ursules</Lieu> 
<Ensemble> "Le Poeme Harmonique" </Ensemble> 
</Annonce> 
<Annonce> 
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<Date> 

<Jour id="jeu'7> 

<Quantieme>17</Quantieme> 

<Mois id="jnv'7> 

<Annee>2002</Annee> 

<Heure>20H30</Heure> 
</Date> 

<Lieu>Chapelle des Ursules</Lieu> 
<Ensemble> "A deux violes esgales" 
</Annonce> 
<Annonce> 
<Date> 

<Jour id="dim'7> 

<Quantieme>24</Quantieme> 

<Mois id="mar'7> 

<Annee>2002</Annee> 

<Heure>17H</Heure> 
</Date> 

<Lieu>Chapelle des Ursules</Lieu> 
<Ensemble> "Ensemble Baroque de Nic 
</Annonce> 



</Annonces> 



Le programme doit done calculer le No desemaine, connaissant lequantieme, le No de 
mois, et I 'ann.ee. Predsement, e'est I'une des fonctions disponibles dans la xsltsl (XSLT 
Standard Library) ; il suffit done d'indure le bon module et d'appeler le bon modele 
nomme : 

planning.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
si :stylesheet 
xmlns:xsl="http://www. w3.org/1999/XSL/Transform" 
xmlns:dt="http: //xsltsl .org/date-time" 
version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl : include href ="../. ./xsltsl -1 .O/date-time.xsl "/> 

<xsl variable name="Dictionnai re" 

select="document('dictionnaire.xml ' )/Dictionnai re"/> 

<xsl :template match="Annonce"> 

<xsl variable 

select="./Date/Quantieme" /> 
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<xsl:variable 




name="NoMois" 




select="$Dictionnaire/mot[@id=c 


rrent()/Date/Mois/@ 


<xsl. -variable 




name="annee" 




select="./Date/Annee" /> 




<xsl variable name="NoSemaine"> 




<xsl : call -tempi ate name="dt:cal 


ulate-week-number"> 


<xsl :with-param name="year" 


select="$annee"/> 


<xsl :with-param name="month 


select="$NoMois"/> 


<xsl :with-param name="day" 


elect="$quantieme'7 


</xsl :call -template) 




</xsl:var1able> 




<xsl :text> 




Semaine </xsl :text> 




<xsl :val ue-of select="$NoSemaine"/> 




</xsl :templ ate> 





ect=" ./Ensemble"/) 



<xsl template match="text( )" /> 
</xsl: stylesheet) 

Pour obtenir le bon numero de mois, on se base comme dans I'exemple (voir Exemple, 
page 223) de la traduction par dictionnaire (bien qu'il n'y ait pas de traduction a faire 
cette fois-ci), legerement modifie pour faire figurer les numeros de mois (seuls les mois 
utiles sont montres, pour gagner de la place) : 



Dictioi 



lain 



■ xml 



<?xml v( 
<Dictior 



;ncoding="UTF-16" standalor 



aire) 



<mot id="jnv" r 

<traductior 
<traductior 
</mot> 



ivier</traduction> 
iuary</traduction> 



<mot id="mrs" 
<traductic 
<traductic 

</mot> 



<mot id="nov" 
<traductic 
<traductic 
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Leresultatobtenu est eel ui montre plushaut. 

On observera ledomaine nominal impose parxsltsl ("http://xsitsi .org/date-time"). 
associe au prefixe "dt:" qui qualifie lenom du modelea appeler (dt:caicuiate-week- 

number). 

On remarquera aussi au passage I 'emploi de la fonction current( ), exactement pour la 

memeraison que celle qui aete vuetoutala fin dela section Exemple, page 187. 

A titrede curiosite, voici le code XSLT correspondantau modelenommedt:caicuiate- 

week-number : 



date-time.xsl (extrait) 

<?xml version="1.0" encoding="UTF-16" standalc 
<xsl :stylesheet 



versioi 



= "!.( 



extension-element-prefixes="doc" 
xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 
xmlns:doc="http://xsltsl .org/xsl /documentation/1.0" 
xmlns:dt="http://xsltsl .org/date-time" 



;1 :template name="dt:calculate-jul ian-day"> 
<xsl:param name="year"/> 
<xsl:param name="month"/> 
<xsl :param name="day"/> 



<xsl 



iable 



</xsl :templ ate> 



<xsl :template name="dt:calcu 


<xsl :par 


m name="year"/> 


<xsl :par 


m name="month"/ 


<xsl:par 


m name-"day"/> 


<xsl:var 


able name="J"> 


<xsl 


cal 1 -template n 


<xsl 


with-param name 


<xsl 


with-param name 


<xsl 


with-param name 


</xs 


:call -template> 



ime="a" select="floor( (14 - $month) div 12)"/> 
ime="y" select="$year + 4800 - $a"/> 
ime="m" select="$month + 12 * $a - 3"/> 

?lect="$day + floor((153 * $m + 2) div 5) + 

$y * 365 + floor($y div 4) - floor($y div 
floor($y div 400) - 32045"/> 



="dt: calculate- Jul ian-daj 
:="year" select="$year"/> 
:="month" select="$month"/> 
:="day" select="$day"/> 
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<xsl variable name="L" select="floor($d4 div 1460)"/> 

<xsl variable name="dl" select="( ($d4 - $L) mod 365) + $L"/> 

<xsl:value-of select="floor($dl div 7) + l"/> 
</xsl :template> 

</xsl:stylesheet> 

Quand on voit ce a quoi on a echappe, on se dit que finalement, ce n'est pas plus mal 
qu'il existe uneXSLT Standard Library , et une instruction xsi :inciude pour s'en ser- 
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Syntaxe 



<xsl : import 

href="... 



L'attribut href nedoit pasetre un descripteur de valeur differee. 

instruction xsi import doit apparaitre comme instruction de premier niveau, etdeplus 
doit apparaitre avant toute autre instruction. 



Semantique 



instruction xsi : import permet d'incorporer au fichier source XSLT courant les ins- 
tructions XSLT d'un autre fichier sourceXSLT dont I'URI estfourni par l'attribut href. 
La difference avec xsi : include tient a ce que les conflits, en casde definitions multiples 
d'une meme instruction XSLT, nesont pas necessai rement des cas d'erreurs, et peuvent 
etre resolus grace a des regies specifiques. 

L'interpretation de la valeur de l'attribut href se fait comme pour I'instruction xsi : 
include (voir Semantique, page 374). 

Processus mis en ceuvre 

Le processus d'incorporation des instructions XSLT provenant d'une feuille de style 
importee est le meme que eel ui d'une inclusion (voir Processus mis en a?uvre, page 375). 
Ce qui change, e'est I 'interpretation du resultat une fois ^incorporation terminee. On 
peutexprimercelaassezfacilementsur un dessin (voir figure 7-1, ou A, B, C, etD repre- 
sented des instructions XSLT quelconques) : dans le cas d'une inclusion, la double 
presence de I'instruction B pose (en general) probleme, mais pas dans le cas d'une 
importation. 
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Figure 7-1 

Comparison 
inclusion- 
importation. 



euille XSLT 

include - 



import - 
•A 



resultan te 

M-D 



Note 

La figure 7-1 suggere un conflit potentiel entre I'element B de la feuille principal et I'element B de la feuille 
importee. Neanmoins, il fautgarder a I'espritqu'une stride identite d'element n'estpas necessaire a I'apparition 
d'un conflit: deux regies de transformation de motifs differents peuvent tres bien engendrer un conflit sur un 
certain noeud, si les deux motifs concordent simultanement avec ce nceud. La figure est ici un support visuel qui 
permetde mettre en evidence les endroits ou Ton discute d'un conflit, mais elle ne doit pas faire croire que les 
conflits ne peuvent pas surgir ailleurs. 



Dans le cas d'une importation, le conflit entre les deux instructions B, s'il existe, est 
resolu par la prise en compte d'un indicateur de preseance. Cet indicateur est un entier 
d'autant plus negatif que la preseance est faible: danslecasdela figure 7-1, le B vain- 
queurestcelui qui provientde la feuillecourante, (preseanceO), alorsque I'autreB, pro- 
venant de la feuille importee, a la preseance -1 (les valeurs absolues de ces indicateurs 
sont arbitral res : cequi compte, cesontleurs valeurs relatives). 

Le cas simple, pour le calcul de cet indicateur, est celui ou chaque feuille ne contient 
qu'uneseule instruction xshimport; dans cecas la valeur absolue del 'indicateur est le 
nombred'importationsqui separe I 'element importede la feuillecourante (voir figure 7-1). 

Dans I'exemple de la figure 7-2, I'element E a la preseance (-2) parce qu'il y a deux 
importations a effectuer pour I'incorporer a la feuille courante. 

Le cas general est celui oti il peut y avoir plusieurs instructions xsi :import dans cer- 
taines des feuilles XSLT (voir figure 7-3). 
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Figure 7-2 

Importations en 
cascade, calcul 
dela preseance. 




Feuille resultante 








d 
c 
b 
a 


•B(-3) 
•D(-3) 






•B(-2) 
•E (-2) 




•B(-l) 
•D(-l) 


•A(0) 
•B(0) 
•C (0) 









Done le dernier sous-arbre d'importations issu du dernier xsi : import, dans I'ordre de 
lecture de la feuille courante, a preseance sur I 'avant dernier, qui lui-meme, a preseance 
surcelui qui I e precede, etc. 

Dans notre exemple, cela veut dire que les indicateurs de preseance, pour les elements du 
sous-arbre issu de la feuille (c), sont tous superieurs aux indicateurs affectes aux ele- 
ments du sous-arbre issu dela feuille (b). 

II faut done faire le calcul en partant du dernier xsi : import, et en calculant des indica- 
teurs de preseance toujours de plus en plus faibles : on applique la regie du pipe pour 
choisir unebranche, etcelledu nombre d'importations quand on suitunebranche. 

A noter que les instructions xsi : include ont bien sflr un effet nul dans ce calcul ; e'est 
pourquoi les elements B des feuilles (f) et (b) ont meme indicateur de preseance. 

Une fois qu'on a les indicateurs de preseance, on s'en sert uniquement s'il y a con//it, 
pour choisi r I 'element a prendre en compte. Si deux elements de meme preseance sont en 
conflit, e'est un cas d'erreur, le processeur XSLT pouvant eventuellement choisir de 
prendre le dernier element dans I'ordre de lecture de la feuille resultante. 

Comme d'habitude, lorsque la detection d'un conflit repose sur une comparaison de 
noms prefixes, il ne faut pas se laisser abuser par des prefixes eventuellement differents : 
cequi compte, ce sont les domainesnominaux, pas les prefixes. 
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Figure 7-3 

Arbred 'importations, 
calcul dela preVance. 




Feuille resultante 









9 
f 

b 

e 

d 

c 

a 


•B(-5) 




• B (-4) 


• B (-4) 

• D (-4) 


•E (-3) 


•B(-2) 


•B(-l) 

•D(-l) 


•A(0) 
•B(0) 
•C(0) 









Regie du pipe 

Premier importe, premier ecarte : autrement dit, dans une feuille XSLT, la derniere importation, dans I'ordre di 
lecture du document, a la preseance la plus grande. 
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Interetde I'instruction xskimport 

L'instruction xsi : import a un air defamilleavec I 'heritage dans les langages a objets : 

une classe A peut heriter d'une classe B, et dans ce cas A « recupere » les methodes et 

attributs declares dans B. S'il n'y aaucun recoupemententre les classes A etB, I 'heritage 

revient a une simple addition des methodes et attributs de B dans A. M ais A peut aussi 

redefinircertaines methodes de B, ce qui revient a dire que A n'accepte pas tout I 'heritage 

deB tel quel. 

II en vadememeavecxsi : import : si A importeB, il herite des elements definis dans B, 

maisil peut aussi en redefinir certains. 

En resume, xsi :inciude, c'est de I 'heritage sans redefinition, alorsquexsi import, c'est 

de I'heritage avec redefinition possible : on utilise xsi :inciude quand on est satisfait de 

cequ'on recupere, etxsi : import quand on aimeraitbien personnaliser certains elements. 



Exemple 



L'exemple que nous allons voir va montrer comment personnaliser un element de 
DocBook. 



Docbookestune DTD associee a des feuillesde style XSLT pour rediger des articles, des livres, et plus genera- 
lementde la documentation. Les feuilles de style XSLT produisentdu HTML ou du FO, lequel donne du PS ou 
du PDF avec des processeurs FO adequats (voir http://docbook.org). 

A titre de curiosite, voici un extrait de document redige en DocBook : 

<?xml version="1.0" encoding="UTF-16" ?> 
<!DOCTYPE article SYSTEM "customdocbook.dtd"> 
<article lang="fr"> 
<articleinfo> 
<author> 

<fi rstname>Phil ippe</fi rstname> 

<surname>Drix</surname> 

<affiliation> 

<jobtitle>Consultant Architectures Objet</jobtitle> 
<orgname>Objectiva</orgname> 
</affiliation> 
</author> 
<title>SPECIFICATION XML DU REFERENTIEL METIER DE L' APPLICATION 

CANOFETE</title> 
<revhistory> 

<revision> 

<revnumber>1.0</revnumber> 

<date>7-XI-200K/date> 

<authorinitials>PhD</authorinitials> 
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</revhistory> 

</articleinfo> 

<abstract> 

<para>Ce document presente les composants XML de 1 'appl ication 
Canofete, cote referential metier, et non cote presentation. 
Ces composants XML sont tous lies au generateur de code Java, 
et decrivent les transactions et les services fonctionnels.</para; 

</abstract> 

<sectl> 

<title>Introduction - Structure generale</title> 
<sect2> 

<title>Fichier <emphasis>Cycl aModel .xml</emphasis></title> 



Le generateur part du fichier 

XML <filename>CyclaModel.xml</filename>, qui 

decrit la correspondance entre les objets metier 

differentes tables de la base de donnees LASSO. 

</para> 



DocBook est disponible gratuitement sur le site precite, et apres installation, on obtient 
(entre autres) des feuillesde style pour un rendu HTM L ou FO. 

On peut bien sur utiliser DocBook tel quel ; maisvoici le debut del a feui lie de style prin- 
cipale: 



<?xml version='1.0'?> 

<xsl:stylesheet xmlns :xsl="http://www. w3.org/1999/XSL/Transfc 

xmlns:doc=" http://nwalsh.com/xsl/documentatic 

exclude- res ult-prefixes= "doc" 

<xsl:output method="html " 

encoding="IS0-8859-l" 



$Id: docbook.xsl.v 1.6 2001/07/04 16:17:43 uid48421 Exp $ 



file is part of the XSL DocBook Stylesheet distributi 
../README or http://nwalsh.com/docbook/xsl/ for copyri 
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<xsl: 


include 


href= 


'../VERSI0N"/> 


<xsl: 


include 


href= 


•param.xs 


1'7> 


<xsl: 


include 


href= 


'../lib/1 


ib.xsl"/> 


<xsl: 


include 


href= 


•../commo 


n/110n.xsl"/> 


<xsl: 


include 


href= 


'../commo 


n/common.xsl"/> 


<xsl: 


include 


href= 


'../commo 


n/labels.xsl"/> 


<xsl: 


include 


href= 


'../commo 


n/titles.xsl"/> 


<xsl: 


include 


href= 


'../commo 


n/subtitles.xsl"/> 


<xsl: 


include 


href= 


'../commo 


n/gentext.xsl"/> 


<xsl: 


include 


href= 


"autotoc. 


xsl"/> 


<xsl: 


include 


href= 


"lists. xs 


T/> 


<xsl: 


include 


href= 


"callout. 


xsl"/> 


<xsl: 


include 


href= 


"verbatim 


.xsl"/> 


<xsl: 


include 


href= 


"graphics 


.xsl"/> 


<xsl: 


include 


href= 


'xref.xsl 


■/> 


<xsl: 


include 


href= 


"formal .x 


sl"/> 


<xsl: 


include 


href= 


'table. xs 


1'7> 


<xsl: 
<xsl: 


include 


href= 
href= 


'sections 

•inline. x 


.xsl"/> 
sl"/> 



L a feui I lede style commence done par un grand nombre conclusions, etnotamment eel le 
du fichier Inline. xsl. 



Cefichieriniii 
inline.xsl 



i contient (entre autres) les regies suivantes : 



<xsl : tempi ate name="inl ine.monoseq"> 
<xsl:param name="content"> 
<xsl :call-template name="anchor"/> 
<xsl :apply-templates/> 
</xsl :param> 

<tt><xsl :copy-of select="$content"/X/tt> 
</xsl :template> 

<xsl :template match="filename"> 

<xsl :call-template name="inline.monoseq"/> 
</xsl: tempi ate> 

On voitquelecontenu dela balise<fiiename> est rendu en XHTM L sous la forme <tt> 
. . . </tt>. Supposons que cela ne nous plaise pas completement : on voudrait qu'un nom 
declasseCSS soit precise, afin qu'il puisseetrepossibledereglerfinementlerendu d'un 
nom de fichier, commececi : 

<tt class="filename">CyclaModel .xml</tt> 

Avec une importation, e'esttres simple a faire : on constitue unefeuille princi pale dans 
laquelle on importedocbook.xsi, puis on redefinit ce qui neva pas. 
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monDocBook.xsl 

<?xml version='1.0'?> 
<xsl :stylesheet xmlns: 



="http: //www. w3.org/1999/XSL/Transform" 



xmlns="http: //www. w3.org/TR/xhtmll/transitioi 
exclude-result-prefixes="#default"> 



<xsl rtemplate name="inl ine.monoseq"> 
<xsl :param name="cssClassName"/> 
<xsl:param name="content"> 
<xsl :call -template name="anchor"/> 
<xsl :apply-templates/> 
</xsl :param> 

<tt class="{$cssClassName}"Xxsl :copy-of select="$content"/X/tt> 
</xsl :template> 

<xsl :template match="filename"> 

<xsl :call-template name="inl ine.monoseq"> 

<xsl :with-param name="cssClassName" select=" 'filename "7> 

</xsl :cal 1 -tempi ate> 
</xsl :template> 



</xsl:stylesheet> 

L e resultat est conforme aux arterites. 
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Syntaxe 



xsl : apply- imports 

<xsl :apply-imports/> 

L'instruction xsi :appiy-imports ne doit pas apparaitre comme instruction de premier 



Regie XSLT typique 

Une regie XSLT utilisant ^instruction xsi :appiy-imports sera souvent employee 
comme ceci : 

<xsl rtemplate match="... motif (pattern) ..."> 

<xsl :apply-imports/> 
</xsl :templ ate> 
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Semantique 

L'instruction xsi :appiy-imports est une instruction qui ne sert que lorsqu'on redefinit 
une regie de transformation importee (heritee) d'une autre feuille de style. II y a alors 
deux cas possibles: 

• Lenouveau modele de transformation n'a pas grand-chose avoir avec I'ancien (celui 
qu'on redefinit) ; dans ce cas, l'instruction xsi : appiy-imports n'estd'aucun secours, 
inutile de I 'uti User. 

• Le nouveau modele de transformation se contente d'ajouter quelque chose de plus a 
I'ancien ; dans ce cas, pourquoi recopier I'ancien ? II vaut beaucoup mieux avoir une 
instruction qui permette de demander I 'application del'ancienneregle: c'estlebutde 

xsi :apply-imports. 

Done, lors de I'instanciation de l'instruction xsi :appiy-imports, le processeur XSLT 
relance une recherche des regies dont le motif concorde avec le nceud courant, mais 
limite sa recherche aux regies dont la preseance est plus faible que celle de la regie en 
cours (Processus mis en ceuvre, page 381) ; ces regies sont done necessairement des 
regies importers, et au cas ou plusieurs conviendraient, celle qui a la preseance la plus 
forte est choi si e. 

Si I'on reprend I'exemple de la figure 7-3, de la section Processus mis en ceuvre, 
page 381, et que I'on suppose que I'element B, dans la feuille (a), est une regie dont le 
modele de transformation contient l'instruction <xsi :appiy-imports/>, alors I'instan- 
ciation de cette instruction <xsi :appiy-imports/> se traduira par I'application de la 
regie B de la feuille (c), puisque e'est celle dont le motif va a nouveau concorder avec le 
nceud courant, et dont la preseance est la plus forte parmi les feuilles de preseance plus 
faible que celle de la regie en cours. 
Le modele de transformation de la regie trouvee est alors instancie, et cette instanciation 

est Celle de l'instruction <xsl :apply-imports/>. 

Remarque 

L'instanciation d'une instruction <xsi :appiy-imports/> necessite de connaitre deux choses : la regie courante, 
et le nceud courant : la regie courante, parce qu'on en cherche une autre de meme mode, (s'il y en a un), et le 
nceud courant, parce que le motif de la regie choisie doit concorder avec ce nceud courant. C 'est pourquoi cela 
n'auraitpas desens d'instancierune instruction <xsi :appiy-imports/> al'interieurdu modele de transforma- 
tion d'une instruction <xsi :for-each>, puisque par definition, cette instruction modifie le nceud courant (ete'est 
la seule qui sache faire cela). Pour cette raison, il est interditde placer une instruction <xsi : apply- imports /> a 
I'interieur d'une instruction <xsi :for-each>. 

Enfin, si I'on reprend I'analogie entre xsi nmport et I 'heritage des langages aobjets, on 
voit immediatement que <xsi :appiy-imports/> reprend I 'idee d'un objet qui, lors de 
I'execution d'une methode heritee et redefinie, lance I'execution de la version originale 
de la methode courante (mot cle super en J ava et en Smal Italk), telle qu'on la trouve dans 
la classe heritee. 
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Attention 

Neanmoins, il ne faut pas pousser I'analogie trap loin, car dans le cas d'un langage a objets, la methode liee a 
super estconnue a priori, alors que dans le cas de XSLT, on recommence une nouvelle recherche de regie par 
concordance de motif parmi les regies de preseance inferieure, de sorte qu'on peuttres bien selectionnerfinale- 
ment une regie dont le motif n'a pas du tout le meme aspect que celui de la regie courante. 
Dans lecas de la figure 7-3, parexemple (voir Processus mis en ceuvre, page 381), il pourraittres bien sefaire 
que I'element D de la feuille (c) soit une regie de transformation contenant I'instruction <xsi :appiy-imports/>, 
dontl'instanciation se traduise finalement par I'activation de la regie E de la feuille (e). 



Exemple 



Nous reprendrons a nouveau comme exemple ce qui est fait dans DocBook (voir 
Exemple, page 385). L'instruction <xsi :appiy-imports/> y est utilisee (entre autres) 
pour resoudre elegamment le probleme maintenant decrit. 

On a un certain nombre de balises pour decrire la structure d'un document, parmi les- 
quelles: <para>, <secti>, <sect2>, <chapter>, etc., dont les noms parlent d'eux-memes. 
On a done en consequence, dans docbook.xsi, des regies pour definir le rendu (HTML 
ou FO) dechacun deces elements. Parexemple: 



<xsl :template matct 
<P> 



;xsl:if test="position( 

<xsl :cal 1 -template na 

<xsl:w1th-param nam 

</xsl :call-template> 

:if> 



= 1 and parent: :listitem"> 



:="node" select="parent: :1 istitem"/> 



</xs 

<xsl : call -tempi ate name="anchor"/> 
<xsl :apply-templates/> 
</p> 
</xsl :template> 

On suppose maintenant que I'on veutecrire une documentation technique qui mette en 
evidence les evolutions par rapport a la version precedente. Ces evolutions peuvent etre 
des modification, des ajouts, ou des suppressions. Docbook fournit de quoi faire cela. 1 1 

SUffit de rajOUter Un attribut revisionflag ( added, deleted, changed) SUr les elements 

concerned : 

<para revisionflag="added" > 

Le generateur part du fichier 

XML <filename>Cycl aModel .xml</filename>, qui 

decrit la correspondance entre les objets metiers et les 

differentes tables de la base de donnees LASSO. 

</para> 

Pour beneficierdela prise en charge decet attribut, il suffitde lancer I 'execution non pas 

de docbook.xsi, maisdechangebars. xsl. 



Instruction xshapply-imports 



Voici la fa§on dont est real isee cettefeui I lede style: 

changebars.xsl 

<?xml version="1.0"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl : import href="docbook.xsl "/> 

<xsl:param name="show. revisionflag" select=" '1 "7> 

<xsl :template name="user.head.content"> 
<style type="text/css"> 
<xsl:text> 

div. added { background-color: yellow; } 
div. deleted { text-decoration: line-through; 

background-color: #FF7F7F; } 
div. changed { background-color: lime; } 
div. off { } 

span. added { background-color: yellow; } 
span. deleted { text-decoration: line-through; 

background-color: #FF7F7F; } 
span. changed { background-color: lime; } 
span. off { } 
</xsl:text> 
</style> 
</xsl :templ ate> 



<xsl :when 






test=" loc 


al-name( 


) = 'para' 
) = 'section' 


or loc 


al-name( 


) = 'sectl' 


or loc 


al-name( 


) = 'sect2' 
) = 'sect3' 
) = 'sect4' 
) = 'sect5' 


or loc 


al-name( 


) = 'chapter' 


or loc 


al-name( 


) = 'preface' 

) = ' itemized! i st' 

) = 'glossary' 


or loc 


al-name( 


) = 'bibliography' 


or loc 


al-name( 


) = 'index' 

) = 'appendix' "> 



;s=' {©revisionflag} ' 



Decoupage d'une application XSLT 



:sl :apply-imports/> 



</xsl :choose> 
</xsl :template> 

</xsl:stylesheet> 

Vous voyez la simplicite avec laquelle cette modification somme toute non triviale a ete 
real i see : une regie (une seule), dont le motif Concorde avec tout element possedant un 
attri but revisionfiag a ete ecrite. Son instanciation produit un bloc <div> equipe d'un 
attri but declasse CSS pour la mise en evidence de la modification apportee, puis le rendu 
de I 'element concerne est laisse aux regies de la feuille importee, et immerge dans I e bloc 
<div>. A noter qu'on est ici dans un cas ou le motif de la regie a selectionner dans la 
feuille importee est selon toute vraisemblancetres different du motif de la regie courante, 
puisqu'a priori, il n'est pas question de revisionfiag dans la feuille originale. 



Evolution 



Le Working Draft XSLT 1.1 a propose d'ajouter une possibi I ite de transmettre des argu- 
ments lors de I'appel <xsi :appiy-imports>, suivant le meme schema que pour 
<xsi : apply- tempi ates>. Cette proposition a ete reprise par I e Working Draft XSLT 2.0. 



Deuxieme Partie 



Design patterns 



C hapitre 8. Patterns de programmation 395 

C hapitre 9. Patterns de transformation 443 




Remarque 

Si Ton regarde le Dictionnaire historique de la langue franpaise(Dictionnaire historique de la langue frangaise, 
sous la direction d'Alain Rey, Dictionnaires Le Robert, Paris, 1998), a I'entree Paterne, ontrouve : adjectif carac- 
terisant un air de bienveillance paternelle ; derive du latin « pater, pere ». Si Ton regarde ensuite I'arbre de 
derivation du mot latin « pater », I'une des branches mene au frangais « patron ». A I'entree « Patron », on 
trouve (entre autres) : vers 1100, signifie « modele, exemple d'un livre », puis devientun terme metier designant 
le modele suivant lequel on fabrique un objet. L'anglais « pattern » est la forme alteree du moyen anglais 
« patron » (xn e siecle), emprunte a cette epoque au frangais sans changement de sens. 
La boucle est bouclee : le frangais paterne et l'anglais pattern sontdeux mots de la meme origine, etplutotque 
de traduire pattern, je prefere reprendre le mottel quel ; il sera it possible de changer legerement la graphie, pour 
lui redonner un aspect frangais, par exemple en ajoutant un « e » final, mais cela aurait peut-etre tendance a 
derouterles lecteurs habitues a employer ce mot anglais sans trapse poser de questions. 
A noterque l'anglais pattern a deux sens assez differents pource qui touche XSLT : il y a pattern au sens de 
motif, pourles attributs match de xsi : tempi ate, xsi :key, etc., et il y a pattern au sens de design pattern. II 
n'estdonc pas plus mal de garderdeux termes differents en frangais, motif et pattern. 
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Patterns de programmation 



Les patterns de programmation sontdes combinaisonsd'elements de programmation en 
XSLT qui reviennentsouventdans la pratique. 

C es patterns ne sont en general pas des buts en soi , mai s pi utot des etapes dans I e proces- 
sus de creation d'une certaine feuille de style. XSLT estun langage encore tresjeune, il 
est done certain qu'on est loin d'avoir identifie tousles patterns de programmation. II est 
meme probable que certains patterns n'ont encore jamais ete imagines par personne. II ne 
faut done en aucune facon considerer ce catalogue comme exhaustif . A u contraire, il faut 
s'attendreacequ'il s'etoffedeplusen plus. 



Pattern n° 1 - Inclusion conditionnelle de feuille de style 

Motivation 

Les inclusions conditionnel les sont des inclusions defeui lies de style differentes en fonc- 
tion d'une certaine condition evaluee a I'execution. Les motivations pour realiser de tel- 
les inclusions conditionnel les peuvent etre classees en deux categories : les bonnes et les 
mauvaises. Quoi qu'il en soit, elles se heurteront toujours a une triste realite : e'eststric- 
tement impossible a faire en XSLT, que ce soit d'une facon directe en utilisant un des- 
cripteurdevaleurdiffereed'attribut href (chose qui n'estpasautoriseeparlagrammaire 
XSLT), ou par I'une des nombreuses manieres detournees (dont on a trace dans les 
mailing-lists ou forums consacrees a XSL) qui ont ete imaginees par des utilisateurs 
s'acharnant sur ce probleme insoluble. 
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Realisation 

En reprenantnotreclassemententre bonne etmauvaise motivation, on peutdirequ'il y a 
deux manieres de s'en sortir : 

• soit prendre conscience qu'une inclusion conditionnelle est une mauvaisereponse a un 
vrai probleme (dans cecas voir si uneinversion de perspective entrefeuilles incluantes 
et feuilles incluses neseraitpasla bonne solution) ; 

• soit s'orienter vers une solution ou I'on doit ecrire une feuille de style qui produit 
comme resultat une nouvelle feuille de style, dont les instructions xsi : include sont 
exactement adaptees au cas determine dynamiquement dans la premiere feuille. 

Dans ce dernier cas, ou une feuille de style en genere une autre, reportez-vous a la section 
Pattern n° 15 -Generation d'une feuille de style par une autre feuille de style, page 507, 
pour un exemplede realisation il lustrant ce principe. 

Pour le premier cas, ou I'on doit evaluer la solution del'inversion de perspective, I 'idee 
est la suivante : une feuille de style A (contenant des transformations standard), veut 
inclure conditionnellement une feuille de style B ou C ou D ... (contenant des vari antes 
particulieres), a choisir entre plusieurs possibles, en fonction par exemple d'un profil 
d'utilisateur. L'inversion de perspective consiste a creer n feuilles de style principales B, 

C, D qui toutes, incluent la feuille standard A. L'aspectconditionnel de I'affaireest 

alorsreporteaun niveau superieur, celui ouon lance I 'execution de la feuille de style: il 
s'agit de lancer la bonne, en fonction de conditions qui ne sont plus du ressort d'XSLT, 
maisdel'environnementd'execution (shell scripts, servlets, etc.). 

Pattern n° 2 - Fonction 

Motivation 

En XSLT, il y a desfonctions predefines au sens habituel du terme, mais il n'y a pasde 
construction, dans lelangage, qui permettededefinir une fonction renvoyant unevaleur. 
Cequi s'en rapproche le plus, c'estle model enomme, qui peutetreappeleavec des argu- 
ments, comme c'estle cas pour unefonction. M ais unefonction renvoi e unevaleur, alors 
qu'un modelenomme instancieun modelede transformation. II est toutefois possible, en 
y mettantun peu du sien cote appelant, d'ecrireun modelenomme qui fait comme si une 
valeuretaitrenvoyee. 



Realisation 



L'ideeestde recuperer le resultat del'instanciation dans une variable, et de renforcer la 
lisibilitedu modele nomme en tant que fonction en uti I isant une variable result. 

Model e nomine renvoyant une valeur 

<xsl :template name="xxx"> 
<xsl :param name="yyy"/> 
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<xsl variable name="result"> 

... corps de la "fonction" ici ... 
</xsl: variable) 

<xsl:copy-of select="$result" /> 
</xsl :template> 

L'instanciation du modelede transformation (i.e. le corps de la « fonction ») a lieu dans 
la variable result ; cette instanciation peutetreabsolumentquelconque, etproduireune 
chalne de caracteres ou un nombre, ou un node-set sous la forme d' un TST (voir Temporary 
Source Tree, page 192). 

La variable result a un effet essentiel sur la clarte de lecture du modele nomme : elle 
annonce qu'il y a un resultat (done que I'on tente de mimer une fonction), et que e'est 
elle qui va contenir ce resultat. Cette variable n'ayantaucun effet algorithmique propre- 
mentdit, elle pourraittres bien etreeliminee, si I'on n'avait pas dans I'ideede I'utiliser 
uniquement pour son effet d'annonce. 

Pour que le modele nomme puisse transmettre effectivement quelque chose a I 'appelant, 
il faut done instancier en derniere instruction une copie du resultat, e'est-a-dire de la 
variable result. Ici, une instruction xsi :vaiue-of ne suffirait pas toujours, car il faut 
prevoir le cas ou la variable resui t contient un TST. Dans ce cas, xsi : copy-of est indis- 
pensable pour realiser une copie complete de tout ce qui se trouve dans cette variable ; et 
comme xsi :copy-of est equivalence a xsi :vaiue-of pour des valeurs simples comme 
string ou Number, on peutdonc utiliserxsi : copy-of dans tous les cas de figure. 

Appel du modele nomme renvoyant une valeui 



<xsl :variable name="resu 


lt-x; 


<x"> 




<xsl : call -tempi ate n 


ame=' 


"xxx°> 




<xsl :with-param 


name^ 


="yyy" 


select=".. 


<xsl :with-param 


name^ 


--"zzz" 


select=".. 


</xsl :call-template> 








</xsl:variable> 









L'appel n'est pas transparent : pour obtenir I 'effet recherche, il faut aussi adopter des 
conventions d'appel. Le resultat renvoye par le modele nomme etant une instanciation de 
modelede transformation, il faut recuperer ce resultat dans une variable lorsde l'appel. 
Onenglobedonc l'appel proprementditdansunevariablequelconque, qui va representor 
le resultat de l'appel. Danslecanevasci-dessus, on peut dire que la variable resuit-xxx 
contient le resultat de l'appel de la « fonction » xxx. 

Exemple 

Fonction index-of 

<!-- renvoie 1'indice du debut de 'testString' dans 'aString' --> 
<!-- renvoie -1 si 'aString' ne contient pas 'testString' --> 
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<xsl :template name="index-of "> 
<xsl:param name="aString"/> 
<xsl:param name="testString"/> 

<xsl:variable name="result"> 
<xsl :choose> 

<xsl:when test=" contains( SaString, StestString ) "> 
<xsl variable name="string-Before"> 
<xsl:value-of 

select="substring-before( $aString, StestString )" /> 
</xsl :variable> 

<xsl : value-of select="l+string-length( Sstring-Before )" /> 
</xsl :when> 

<xsl :otherwise> 

</xsl :otherwise> 



<xsl:copy-of select="$resul t" /> 
</xsl :template> 

Appel de la fonction index-of 

<!-- indice de la premiere apostrophe dans 'stringToSpl it ' --> 
<xsl : variable name="indexOf-fi rstApos"> 
<xsl :call-template name="index-of"> 

<xsl :with-param name="aString" select="$stringToSpl it"/> 
<xsl :with-param name="testString" select=' "&apos ;" ' /> 
</xsl:call -template) 
</xsl:variable> 

<!-- indice du premier espace dans 'stringToSpl it ' --> 
<xsl variable name="indexOf-fi rstSpace"> 
<xsl: call -tempi ate name="index-of"> 

<xsl :with-param name="aString" select="$stringToSpl it"/> 

<xsl :with-param name="testString" select= /> 

</xsl:call -template) 
</xsl:variable> 



Pattern n° 3 -Action 

Motivation 

lei, action s'oppose a fonction. Une fonction renvoieunevaleur, alorsqu'une action rea- 
lise un certain traitement. Cequi est tout a fait paradoxal, c'estquelelangageXSLT est 
un langage fonctionnel (embryonnaire, certes, mais pur, en ce sens que la notion d'effet 
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debord affectant les objets mani pules est etrangereau langage) ; etpourtantla notion de 
fonction n'existe pas completement (voir ci-dessus), alors que la notion de modele 
nomme, qui die, existebel etbien, correspondrait plutot a la notion d'action realisantun 
certain effet de bord. Le paradoxe disparait quand on remarque que la seule action que 
puisse real i ser un modele nomme, c'est instancier un modele de transformation. Cela 
peut se traduire effectivement par un effet de bord, mais c'est un effet de bord qui ne 
concerne pas les objets mani pules : 

• soitil affectel'etatdu document resultat a construi re, qui est externeau programme (i I 
n'y a aucun moyen de recuperer dans une variable, ou de quelque autre facon, I'etat 
courant du document resultat en cours de construction) ; 

• soitleflux de sortie de I 'instanciation est capture par une variable, qui estainsi definie 
et initialisee simultanement, mais en aucun cas modifiee (done ce cas n'est pas un cas 
d'effet debord). 

Conclusion 

La seule action possible, en XSLT, c'est I'instanciation d'un modele de transformation. 

C hoi si r entre fonction et action consistedonc a se demander si I'on prefereobtenir une 
valeurou instancier un model ede transformation : si I'on veutobteni rune valeur, utiliser 
le pattern Fonction ; si I'on veut instancier un modele, utiliser I e pattern Action. 



Etant donne qu'un modele de transformation correspond exactement a la notion d'action, 
la realisation est triviale. La seule question est de savoir si I'on realise une action ano- 
nyme, ou si I'on opte pour une action nominee. Dans ce dernier cas, il est bon de 
donner un nom a I 'action qui rappelle explicitement que I 'action est une instanciation. 
Un modele nomme representant une action devraittoujours avoir un nom de la forme 
instancier-xxx, puisqu'il n'y a absolumentaucune autre possibility d'action en XSLT. 

Modele nomme realisant une action 

I <xsl : tempi ate name="instancier-xxx"> 
<xsl:param name="yyy"/> 



... corps du modele de transformation ici . 
</xsl: template) 



Exemple 



On veut instancier un caractere de rembourrage (un caractere qui sert a completer une 
chaine, a gauche ou a droite, afin de lui donner une longueur totale exactement egale a 
une certaine valeur). 
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Action instancier-bourre 

<!-- 'bourre' : le caractere de rembourrage avec l'espace comme valeur par defaut --> 

<xsl :template name="instancier-bourre"> 

<xsl:param name="bourre" select=" '"/> 

<xsl:value-of select= M $bourre" /> 
</xsl :templ ate> 

L'algorithme de I'instanciation de ce modele de transformation ne doit pas vous sembler 
d'un interet extraordinaire ni d'une difficult insurmontable; mais ce qu'il faut remar- 
quer ici, c'est plutot le nom du modele, qui suit la recommandation indiquee plus haut : 
cette action consistant a instancier de la bourre, on I'appelle « instancier-bourre ». 
A noter que le but premier du rembourrage n'est atteint que si cette action est repetee 
autant de fois que necessaire, mais 5a, c'est un autre probleme: c'est un probleme 
d'iteration, que nous allons voir maintenant. 



Pattern n° 4 - Iteration 

Motivation 

En XPath, il n'y a pas d'instruction pour realiser une iteration sur une action. L 'instruc- 
tion xsi :for-each, malgre son nom, n'est pas une instruction d'iteration, mais une ins- 
truction pour changer temporal rement de nceud courant. Or il arrive assez frequemment, 
memeenXSLT, qu'il faille iterer une action, notammentlorsqu'on manipuledeschaines 
decaracteres (mais bien entendu, il n'y a pas dedomaine reserve). 

II y a deux grandes techniques pour iterer une action; la premiere c'est I 'iteration 
recursive, etl'autre, c'est I 'iteration Piez, du nom deson inventeur. 

Etant donne I 'absence d'effet de bord, cela n'aurait aucun sens de vouloir iterer sur un 
appel defonctionenXSLT : ceserait comme demander 5000 fois son prenom a quelqu'un. 

Realisation recursive 

L'idee est ici d'envelopper I 'action a iterer dans un modele nomme qui va s'appeler n fois 
recursivement, n etant le nombre d'iterations a effectuer. Si vous n'etes pas tres a I'aise 
avec la recursion, I'iteration recursive est un bon moyen d'entrer en douceur dans le 
mondefascinantdesabymes. Nousauronsl'occasion de detainer lafacon deconcevoir 
une fonction ou une action recursive, mais ici, il s'agit simplement de repeter n fois une 
action ; le plan etant toujourslememe, il n'y a pas lieu des'appesantir. 

Ingredients : 

• instancier-xxx : le nom de I 'action a repeter (sans oublier ses eventuels arguments) ; 

• n : le nombre d'iterations demande ; 

• iter-instancier-xxx : le nom de I'action iterante. 
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Note 

Repeter n fois une action, c'est une action. Or une action doit avoir un nom de la forme 1 nstanci er-xxx. Effec- 
tivement, si I'on suit cette regie, on ne devraitpas nommer Taction iterante iter-instancier-xxx, mais plutot 
instancier-repetitions-de-instancier-xxx. Apres tout, vous faites comme vous voulez, mais moi, je 
prefere la version abregee. 



Model e nomme realisant la repetition d'une action 

<xsl :template name="iter-instancier-xxx"> 



<xsl:if test="$n > 0"> 






<xsl :cal 1 -tempi ate name 


="insta 


ncier-xx 


<xsl:with-param nan 




select= 


</xsl:call -template) 






<xsl :call-template name 


="iter- 


instanci 


<xsl :with-param nan 


e="n" s 


elect="$ 


<xsl :with-param nan 




select= 


</xsl: call -tempi ate> 






</xsl:if> 






</xsl :template> 







II faut remarquer ici que la recursion employee est diteterminale, cequi signifiequelors 
de I'execution de Paction iter-instancier-xxx, I'appel recursif est la derniere instruc- 
tion a etre executee. Cette propriete est extremement avantageuse pour I 'implementa- 
tion : il est inutile detraiter I'appel recursif en tant que tel, et I eprocesseurXSLT, pour 
peu qu'il sachese livrer a quelques optimisations de base, va pouvoir remplacer I'appel 
recursif par une simple boucle, ce qui sera beaucoup plus economique en terme de 
memoireconsommee. 

Evidemment, une variante de ce pattern pourrait etre d'instancier directement des 
instructions XSLT a la place de I'appel a instancier-xxx, comme ceci : 

Modele nomme realisant la repetition d'une action 

<xsl :template name="iter-instancier-xxx"> 
<xsl :param name="n"/> 



<xsl:if test="$n > 0"> 

<!-- instancier ici directement des instructioi 



;1 :cal 1 -tempi ate nan 
<xsl :with-param na 
<xsl :with-param ne 
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I</xsl : call -tempi ate> 
</xsl:if> 
</xsl: template) 

Exemple 

iterations.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="l.C 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl :template name="instancier-bourre"> 

<xsl:param name="bourre"/> 

<xsl :value-of select="$bourre" /> 
</xsl :template> 

<xsl : tempi ate name="iter-instancier-bourre"> 
<xsl :param name="n"/> 
<xsl:param name="bourre"/> 

<xsl:1f test="$n > 0"> 

<xsl :call -template name="instancier-bourre"> 

<xsl :with-param name="bourre" select="$bourre"/> 
</xsl: call -template) 

<xsl : call -tempi ate name="iter-instancier-bourre"> 
<xsl:with-param name="n" select="$n - l"/> 
<xsl :with-param name="bourre" select="$bourre"/> 
</xsl: call -template) 
</xsl:if> 
</xsl :template> 

<xsl rtemplate match="/"> 

<xsl : call -tempi ate name="iter-instancier-bourre"> 
<xsl :with-param name="n">7</xsl :with-param> 
<xsl :with-param name="bourre">.</xsl :with-param> 
</xsl :call -template) 
</xsl :template> 

<xsl :template match="text( )"/> 

</xsl: stylesheet) 

Resultat 



Le programme ci-dessus, qui peut etre applique a n'importe quel document source XM L, 
reprend I 'action instancier-bourre vue plus haut (voir Pattern n° 3 -Action, page 398), 
et la repete sept fois, avec I e caractere ' . ' comme caractere de rembourrage. 
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Si I'on voulait, il seraittres facilede recuperer leflux de sortie de cette instanciati on pour 
le rediriger vers une variable : 

Recuperation du flux de sortie dans une variable 



<xsl : tempi ate match="/"> 

<xsl :variable name="rembourrage"> 

<xsl:call-template name="iter-instancier-bourre"> 
<xsl :with-param name="n">7</xsl :with-param> 
<xsl :with-param name="bourre">.</xsl :with-param> 
</xsl: call -tempi ate> 
</xsl:var1able> 

... utilisation de la variable $rembourrage ... 
</xsl :template> 



Iteration par la methode de Piez 

Cette forme d'iterati on aete inventee par Wendell Piez, et a ete postee sur la I istede dis- 
cussion XSL www.mulberrytech.com/xsl/xsl-list). E Me est basee sur un principe total ement 
different, qui consiste a utiliser ^instruction xsi :for-each, bien qu'elle ne soit pas du 
tout faite pour 5a. 

Supposonsqu'on aitun node-set NS quelconque, pourvu qu'il possede suffisamment de 
nceuds. Suf/zsamment signifie ici au moinsautantdenceuds qu'il y a de tours de boucle a 
effectuer, maisil peuty avoir beaucoup plus de nceuds que necessai re, peu importe. 

Soit n le nombre de tours de boucle que I 'on veut effectuer. On peut alors real i ser la boucle 
commececi : 

Iteratioi 



<xsl:for-each select="$NS[ positionO < 


$n+l ] 


<xsl : call -tempi ate name="instancier-xxx 




<xsl :with-param name="..." select=" 


..."/> 


</xsl :call-template> 




</xsl:for-each> 





L'astuce consiste a utiliser un predicat qui selectionne exactement n nceuds a parti r du 
node-set NS. Celafait, il est clair que instruction xsi:for-eacn va instancier exactement 
n foisson modelede transformation, etc'estbien la le but de la manoeuvre. 

Reste un leger detail a traiter : comment obtenir un node-set quelconque d'au moins n 
noeuds? II y a evidemment plusieurs reponses possibles. L'une d'entre elles, qui fonc- 
tionne general ement tres bien, est de recuperer les noeuds de I 'arbreXM L correspondant 
au programme XSLT lui-meme(qui, nel'oublionspas, estun documentXML commeun 
autre). Cet arbre XML est recuperable grace a la fonction predefinie documento : 
I'appel document ( "), avec une String vide en argument, renvoiele node-set constituede 
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la racine de I'arbre XM L du programme XSLT dans lequel die est contenue. Unefois 
qu'on a la racine, il n'y a plus qu'a selectionner tous les elements enfants, par exemple : 

document( ' ' )//node( ) 

Evidemment, celanefonctionnequesi la valeur den n'estpastropgrande. Eneffet, pour 
desgrandesvaleursden,on risque d'avoi run node-set trop petit; etmemesi I'on s'inge- 
niait a aller ramasser des noeuds ailleurs, eel a deviendrait un peu deli rant de constituer un 
node- set enorme, juste pour faire une iteration, alors qu'une iteration classique recursive, 
avec recursion terminale, ne consomme pas dememoi re. 



Exemple 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" versic 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl: variable name="PuitsDeNoeuds" select="document( " )//node( )"/> 

<xsl :template name="instancier-bourre"> 

<xsl:param name="bourre"/> 

<xsl :value-of select="$bourre" /> 
</xsl :template> 

<xsl :template name="iter-instancier-bourre"> 
<xsl :param name="n"/> 
<xsl:param name="bourre"/> 

<xsl:for-each select="$PuitsDeNoeuds[ positionO < $n+l ]" ) 
<xsl :cal 1 -template name="instancier-bourre"> 

<xsl :with-param name="bourre" select="$bourre"/> 
</xsl:call -template) 
</xsl:for-each> 
</xsl :template> 

<xsl :template match="/"> 

<xsl : cal 1 -template name="iter-instancier-bourre"> 
<xsl :with-param name="n">7</xsl :with-param> 
<xsl :with-param name="bourre">.</xsl :with-param> 
</xsl : cal 1 -template) 
</xsl :template> 

<xsl :template match="text( )"/> 

</xsl: stylesheet) 

Resultat 
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Pattern n° 5 - Recursion 

Motivation 

Peut-etre pensez-vous que grace aux techniques d'iteration que nous venons de voir, 
vous allez pouvoir echapper a la recursion. M alheureusement, ce n'est pas vrai : un 
probleme aussi simple que de prendre tous les elements <prix devise=". . .-> d'un 
document XML, et d'en calculer la somme, en tenant compte du taux de change 
actuel, nepeutetreresolu sans recursion, a cause de I'impossibilite qu'il y a demet- 
tre a jour une variable. Avoir une possibilite d'iteration ne resout que la moitie du 
probleme. 

Dans un tel cas, la seule possibilite est d'etablir une definition recursive de la valeur a 
calculer, et de coder cette definition en XSLT. 

II est done indispensable de savoir definir un traitement recursif. 



Realisation 

D'une maniere generale, il faut 3 ingredients pour reussir a ecrire unefonction recursive : 

1) un parametre numerique n significatif de la complexite de la mise en ceuvre de cette 
definition, 

2) une solution triviale pour une valeur faible den, en general Oou 1, 

3) un moyen trivial d'obtenir la solution pour la valeur n du parametre, quand on connait 
une solution pour la valeur n-i. 

II peut arriver que le point 1) soit implicite : par exemple une fonction traitant une 
chaine de caracteres peut tres bien reposer sur la longueur de cette chaine, qui 
devient alors implicitement le parametre numerique donnant la complexite de mise 
en ceuvre. 

Un autre point essenti el est qu'il ne faut pas chercher adecrireun algorithme, maisuni- 
quement a definir la fonction ; e'estdejavrai avec deslangagescommejava, C ou Eiffel, 
mais ca I 'est encore pi us en XSLT, qui estassez remarquable dans son pouvoir derendre 
hermetique ce qui n'est pourtant pas si complique. 

II n'est guere possible de continuer en restant dans les generalites ; il faut maintenant 
prendre un exemple. 



Exemple du decompte de mots dans une chaine 

Nous avons une chaine de caracteres constitute de mots separes par un espace. On peut 
supposer que cette chaine est renvoyee par la fonction predefine normal 1 ze-space( ), de 
sorte qu'il n'y a certainement aucun espace ni en tete, ni en fin, et aucune sequence 
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deplusd'un espace a I'interieur. L eprobleme est de compter I es mots, ou, cequi revient 
a peu pres au meme, de compter les espaces. 

II s'agit maintenant de formuler une definition recursive du nombre d'espaces d'une 
chaine : 

nombreEspaces( str ) = 

10 si la chaine str ne contient auncun espace; 
1 + nombreEspaces( substring-aftert str, ' ') ) sinon. 

Lafonction predefiniesubstring-afterc stri, str2 ) renvoie la sous-chaine de stri 
situeeapres la premiere occurrence de st r2 dans stri ; doncici substring-after ( str, 
' ■) va renvoyer la parti ede str constitute des caracteres de str situesapresle premier 
espace de str. 

Vous voyez a quel point la definition de cette fonction est simple ; mais surcharged de 
tout lefatras lexical deXSLT, elledevientassez peu lisible: 



Fonction nombreEspaces( str ) 






<xsl :template name="nombreEspaces"> 






<xsl :param name="str"/> 








<xsl variable name="resul t"> 








<xsl :choose> 








<xsl:when test="contains( $st 




) "> 




<xsl :variable name="nombreEspac 


es-recur 




<xsl :cal 1 -template na 


me="nombreEspa 




<xsl:with-param n 


ame="s 


tr" 




select="substring 


-afte 


( $str, 




</xsl: call -tempi ate> 








</xsl:variable> 








<xsl:value-of select="l + 


SnombreEspace 




</xsl :when> 








<xsl :otherwise> 








</xsl :otherwise> 








</xsl:choose> 








</xsl:variable> 








<xsl :copy-of select="$result"/> 






</x 


si :templ ate> 







Notez que la definition que nous avons adoptee n'est pas compatible avec lecas favo- 
rable d'une recursion terminale. En effet, la definition recursive de cette fonction pro- 
voqueun appel recursif, puisl'addition du resultatobtenu a 1. C'estce« puis » qui est 
desastreux. 

Pour revenir a une definition qui autorise une recursion terminale, I'astuce consiste gene- 
ral ement a reporter le calcul post-appel au niveau des arguments, pour en faire un calcul 
pre-appel. 
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En clair, cela signifie qu'il faut ajouter un nouvel argument, nombre-courant, qui 
contient le nombre d'espaces deja rencontres : 

nombreEspaces( str. nombre-courant ) = 

nombre-courant si la chaine str ne contient auncun espace; 
nombreEspacest substring-after( str, ' '), nombre-courant + 1 ) sinon. 

Pouravoir le nombre d'espaces d'une chaine s, on calculenombreEspaces( s, o ), 

LorsdeSdifferentsappelsreCUrsifSnombreEspacesC str, nombre-courant ), str repreSente 

unechainedeplusen plus courte, et nombre-courant un nombre de pi us en plus grand. 

Remarquons enfin que nous avons fait ici le choix d'une fonction et non d'une action, A 
nouveau, ce choix n'est pas compatible avec une recursion terminale, puisqu'une fonction 
seterminepar un xsi :copy-of. 

Passer d'une fonction a une action est tres simple : il suffit de changer le nom de la fonction 
en nom d'action (instancier-xxx), et de reconstruire les phrases de definition a partir du 
verbeinstancier : 

instancier-nombreEspaces( str, nombre-courant ), c'est : 

- instancier nombre-courant si la chaine str ne contient auncun espace; 

- instancier-nombreEspacest substring-aftert str, ' '), nombre-courant + 1 ) 

Action instancier-nombreEspaces( str. nombre-courant ) 

<xsl :template name="instancier-nombreEspaces"> 
<xsl:param name="str"/> 

<xsl:param name="nombre-courant" select^" '0"7> 
<xsl :choose> 

<xsl :when test="contains( $str, ' ' ) "> 

<xsl :call-template name="instancier-nombreEspaces"> 
<xsl :with-param name="str" 
select="substring-after( $str, ' ')"/> 

<xsl :with-param name="nombre-courant" 
select="l + $nombre-courant"/> 
</xsl :cal 1 -template> 
</xsl :when> 
<xsl: otherwise) 

<xsl :value-of select="$nombre-courant"/> 
</xsl :otherwise> 
</xsl :choose> 
</xsl :templ ate> 

Cettefois, on a bien une recursion terminale, qui pourra done etre optimised en iteration 
parleprocesseurXSLT. Ci dessous, un programme complet, avec les deux methodes. On 
util ise le fait que le parametre nombre-courant possede la valeur par defaut, A insi, lors 
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del'appel initial (voir variable N2, a la fin du programme), il n'estpasbesoindetransmettre 
explicitement cette valeur initiale. 

NombreMots.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 
version="l.l"> <!-- compatibil ite Saxon 6.5 --> 



<xsl:output method='text' encodings' ISO-8 



<xsl :templat 




="nombreEspa 


<xsl :par 




e="str"/> 


<xsl:var 


able 


name="result 



:choose> 

;xsl:when test="contains( $str, ' ' ) "> 
<xsl variable name="nombreEspaces-recur 
<xsl : call -template name="nombreEsp£ 
<xsl :with-param name="str" 
select="substring-after( $str, 
</xsl :cal 1 -template> 
</xsl :variable> 
<xsl :value-of select="l + SnombreEspace 



<xsl :otherwise> 




</xsl :otherwise> 




</xsl :choose> 




</xsl:variable> 




<xsl :copy-of select="$result"/> 




/xsl:template> 




xsl :templ ate name="instancier-nombreEspaces"> 




<xsl:param name="str"/> 




<xsl:param name="nombre-courant" select="'0 


'"/> 


<xsl :choose> 




<xsl:when test="contains( $str, ' ' ) ' 


> 


<xsl : call -tempi ate name="instancier 


-nombreE 


<xsl :with-param name="str" 




select="substring-after( $str. 


, , )V> 


<xsl:with-param name="nombre-co 


urant" 


select="l + $nombre-courant"/> 




</xsl :call -template> 




</xsl:when> 




<xsl :otherwise> 




<xsl :value-of select="$nombre-coura 


nt"/> 


</xsl :otherwise> 




</xsl:choose> 




/xsl :template> 
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<xsl : variabl e name="complainteDuCharretier"> 

Pousser des charettes a longueur de journee reclame de l'energie 
</xsl:variable> 

<xsl : tempi ate match="/"> 

<xsl :call -tempi ate name="nombreEspaces"> 
<xsl :with-param name="str" 

select=" normalize- space ($compl a inteDuCharretier)"/> 
</xsl : call -tempi ate> 
</xsl:variable> 
Nombre de mots = <xsl : value-of select="l + $N1'7> 

<xsl .-variable name="N2"> 

<xsl :call-template name="instancier-nombreEspaces"> 
<xsl :with-param name="str" 

select="normalize-space($complainteDuCharretier)"/> 
</xsl : call -tempi ate> 
</xsl:variable> 

Nombre de mots = <xsl : value-of select="l + $N2'7> 
</xsl :template> 

<xsl :template match="text()"/> 
</xsl: stylesheet) 
Resultat 

Nombre de mots = 10 
Nombre de mots = 10 

Pattern n° 6 -Visiteur recurs if de node-set 

Motivation 

II est tres frequent, en programmation XSLT, que I 'on ait constitue un node-set de noeuds 
possedant une certaine propriety, et que I'on veuille alors appliquer un certain traitement 
a chacun de ces noeuds. Par exempie, on peut vouloir calculer la somme des valeurs 
numeriques de ces noeuds (a supposer qu'ils aient effectivement une valeur numerique), 
ou bien faire une statistique quelconque, comme indiquer la valeur minimale, ou la 
moyenne, ou tout autre chose du meme genre. 

II y a bien unefonction predefine sumo, qui prend en donneeun node-set, etrenvoiela 
somme des noeuds du node-set, a condition bien sur que la valeur textuelle de ces noeuds 
soit numerique. Maisd'unepart, une somme n'est jamais qu'un aspect des choses, et il 
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n'y a pas que des additions dans la vie; etd' autre part, memesi on veutjustementcalculer 
une somme, rien ne dit que la fonction sumo soit la bonne solution, car I 'experience 
montre que les valeurs a sommer sont rarement purement numeriques. 
Si I'on veut sommer des surfaces (pour des pieces demaison, parexemple), il y atoutes 
les chances que les valeurs se presentent sous la forme « 15m2 », ce qui se traduira par un 
magnifique« NaN » (Not a Number) comme resultat final. 

Typiquement, ce qu'il faut pour resoudre ce genre de probleme de facon generique, c'est 
un visiteur, qui definissecequ'est la valeur d'un nceud, la facon de visiter le node-set, et 
Paction a faire a chaque nceud rencontre. 

Remarque 

II ne s'agit pas icid'une visite arborescente :on a un node-set, et on se contente de visiter chaque noeud, sans 
aller explorer les descendants de ces nceuds. Ce ne serait pas forcement sans interet, mais a chacun son 
travail : des qu'il s'agit de naviguer dans les arborescences, XPath est la pour ga ; a nous de lui demander un 
node-set qui contienne tout ce qu'il nous faut, sans etre oblige de finir le travail de navigation. 



Pour realiserun visiteur, il fautd'abord ledefinirrecursivement. Nous allons tout de suite 
faire le choix d'un visiteur sous forme d'action, et nous inspirer de I'exemple precedent 
pour obtenir une recursion terminale. 

Un visiteur doit renvoyer un resultat, etantdonne un node-set ns. Ce resultat sera calcule 
en fonction de la valeur des differents nceuds du node-set ; il faut done supposer qu'on a 
une fonction vaieuro, qui renvoiela valeur d'un nceud. Cette notion de valeur est bien 
sflr susceptible de changer d'un visiteur a I 'autre, en fonction de la semantique du resultat 
a obtenir. 

On suppose enfin que I'on dispose d'une fonction resin tato, qui prend en donneeun 
resultat partiel et la valeur d'un nceud, et qui renvoie un nouveau resultat partiel, mais 
actual ise en fonction du nceud pris en compte. 

Ceci suggerefortement une partition du node-set a traiter : etantdonne un node-set ns, on 
peuttoujoursleconsiderercommeetantforme des nceuds ns[positiono > i] (e'est-a- 
dire, tous les nceuds sauf le premier) et du nceud ns[position() = i] (e'est-a-dire, le 
premier nceud). 

L'action a definir sera done I'action instancier-resultat, dont le cas trivial se reduit a 
instancier le resultat partiel auquel on est parvenu : 

instancier-resultat(ns. resultat-courant), c'est : 

- instancier resultat-courant si ns est vide; 

- instancier-resul tat( ns[position( ) > 1], 

resultatt 

resultat-courant. 
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On peut verifier que cette definition estbien recursive terminal e. 

Une fois obtenue, elle doit etre dedinee suivant les diverses semantiques possibles 
attacheesauxfonctions resuitato etvaieuro, Parexemplelafonction resuitato 
pourra renvoyer le plus petit de ses deux arguments, ou leur somme, ou tout autre 
calcul a partir de ces deux arguments, sachant que le premier represente un resultat 
parti el. 



Application 



Minimum d'un node-set 

Soit par exemple le fichier XML suivant, contenant des descriptions de maisons : 



Maisons.xml 

<?xml versi 



2ncoding="UTF-16" standalc 



<cuisine surface 
Evier inox. 


='12m2'> 

Mobilier encastre 






</cuisine> 








<WC> 








Lavabo. Cumu 


lus 200L. 






</WC> 








<sejour surface= 
Cheminee en 

Carrelage te 


'40m2'> 

pierre. Poutres a 

rre cuite. Grande 


Pi 

ban 


fond. 
; vitree. 


</sejour> 
<bureau surface^ 


'15mZ'> 






Bibliotheque 
</bureau> 


encastree. 






<garage/> 
</RDC> 








<etage> 

<terrasse>Palmie 


r en zinc figurant 


le 


desert. </ter 


<chambre surface 


='28m2' fenStre=': 


'> 




Carrelage terre cuite poncee. 
<alcove surface='8m2' fenetre= 
Lambris. 


■1" 




</alcove> 








</chambre> 








<chambre surface 

Lambris. 
</chambre> 


='18m2'> 







Patterns de programmation 





<salleDeBains surface='15m2'> 




Douche, baignoire, lavabo. 




</salleDeBains> 




</etage> 


</lt 


aiS ° n> 




<RDC> 




<cuisine surface='12m2'> 




</cuisine> 




<garage/> 




</RDC> 




<etage> 




<mirador surface="lm2"> 




Vue sur la mer. Ideal en cas de 




</mirador> 




<salleDeBains surface='15m2'> 




Douche. 




</salleDeBains> 




</etage> 


</lt 


aiS ° n> 




<RDC> 




<sejour surface='40m2'> 




Les plaisirs ont choisi pour as 




Ce sejour agreable et tranquill 




Que ces lieux sont charmants 




Pour les heureux amants. 




</sejour> 




</RDC> 




<etage> 




<chambre surface='17.5m2'> 




Exposition plein sud. 




</chambre> 




</etage> 


</maison> 


</maiso 


ns> 



On souhaiteconnaitrela piece de plus petite surface, parmi toutes les mai sons disponibles. 

Pourcela, nousallonsmettreen place unvisiteur, associeaunefonction vaieuro qui va 
renvoyer la valeurcalculeedel'attri but surface, quand il estdisponible, etlavaleursym- 
bolique NaN (Not a Number), quand il est absent. La valeur calculee de cet attribut est la 
chaine privee de I 'unite (m2), afin d'obtenir une valeur numerique correcte permettant 
les comparai sons: 

fonction valeurQ 

<xsl :template name="valeur"> 
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<xsl:v 


riable name="re 


ult 


> <!- 


<x 


l:variable name 


"su 


face" 


<x 


1 :choose> 








<xsl :when test 


"$s 


rface 




<xsl rvalue 


of 


elect 




</xsl :when> 








<xsl : otherwise 








<xsl rvalue 


of 


elect 




</xsl:otherwis 


> 




</xsl :choose> 






</xsl: 


ariable> 






<xsl:copy-of select="$ 


esu 


t" /> 


</xsl :temp 


ate> 







;lect="$unSingleton/ attribute: : 



substring-before( $surfa( 



"number('NaN')" /> 



Lafonction resuitato seraici lafonctionminimumo, avec unesemantiquequi doit Tes- 
ter COnforme a Ce qui a ete defini plus haut: il faut que minimum( minimum-courant, 

nouveiievaieur ) renvoie un nouveau minimum courant, integrant la prise en comptede 
nouvei i evai eur, ce qui ne semble pas d'une difficult insurmontable : 

fonction minimumO 



<xsl : tempi a 


te name="minimum"> 


<xsl :pa 


ram name="vl"/> 


<xsl :pa 


ram name="v2'7> 


<xsl:va 


riable name="result"> 


<xsl :choose> 




<xsl :when test="string($vl) = 'Na 




<xsl:value-of select="$vl" /> 




</xsl:when> 




<xsl :when test="string($vl) = 'Na 




<xsl :value-of select="$v2" /> 




</xsl :when> 




<xsl:when test="string($v2) = 'Na 




<xsl:value-of select="$vl" /> 




</xsl :when> 




<xsl :when test="$vl > $v2"> 




<xsl :value-of select="$v2" /> 




</xsl :when> 




<xsl :otherwise> 




<xsl:value-of select="$vl" /> 




</xsl :otherwise> 


</x 


si :choose> 


</xsl:v 


ariable> 


<xsl:copy-of select="$result" /> 


</xsl :templ 


ate> 



M aintenant, il n'y a plus qu'a integrer ceci dans un programme d'essai, et a coder en 

XSLT la definition recursive du Visiteur (nomme instancier-min). 
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Chapitre 8 

SurfaceMini .xsl 



(ml version="1.0" encoding="UTF-16"?> 

;1: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1' /> 



<xsl :param name="unSingleton"/> 

<xsl :variable name="result"> <!-- une surface --> 
<xsl : variable name="surface" 
select="$unSingleton /attribute: :surface"/> 

<xsl :choose> 

<xsl:when test="$surface"> 

<xsl :value-of select="substring-before( $surfa( 
</xsl :when> 
<xsl:otherwise> 

<xsl :value-of select="number( ' NaN ' )" /> 
</xsl :otherwise> 
</xsl:choose> 
</xsl:variable> 

<xsl:copy-of select="$resul t" /> 
</xsl :template> 



slrtemplate name="minimum"> 




<xsl:param name="vl"/> 




<xsl:param name="v2"/> 




<xsl variable name="resulf 


> 


<xsl :choose> 




<xsl :when test="str 


ing($vl) = 'NaN' 


<xsl:value-of s 


elect="$vl" /> 


</xsl :when> 




<xsl :when test="str 


ing($vl) = 'NaN'" 


<xsl:value-of s 


elect="$v2" /> 



<xsl:when test="string($v2) = 'NaN' 
<xsl:value-of select="$vl" /> 

</xsl :when> 

<xsl:when test="$vl > $v2"> 

<xsl:value-of select="$v2" /> 

</xsl:when> 

<xsl:otherwise> 

<xsl:value-of select="$vl" /> 

</xsl :otherwise> 



</xsl:variable> 
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<xsl :copy-of s 
</xsl :template> 



<xsl :template name="instancier-min"> 
<xsl:param name="unNodeSet" /> 
<xsl:param name="min-courant" /> 

<xsl :choose> 

<xsl :when test="$unNodeSet"> 

<xsl:call -tempi ate name="instancier-min"> 
<xsl :with-param name="unNodeSet" 

select="$unNodeSet[position() > l]"/> 

<xsl :with-param name="min-courant"> 
<xsl :call-template name="minimum"> 

<xsl:with-param name="vl" select="$min-courant"/> 

<xsl :with-param name="v2"> 

<xsl :cal 1 -template name="valeur"> 

<xsl :with-param name="unSingleton" 
select="$unNodeSet[position() = 1]'7> 
</xsl:call -template) 
</xsl:with-param> 
</xsl:call -tempi ate) 
</xsl:with-param> 
</xsl:call -template) 
</xsl:when> 

<xsl: otherwise) 

<xsl :val ue-of select="$min-courant" /> 
</xsl:otherwise> 
</xsl :choose) 



</xsl :templ ate> 



<xsl :template match="/"> 

<xsl :variable name="surface-mini"> 

<xsl :call-template name="instancier-min") 

<xsl :with-param name="unNodeSet" select="//*"/> 
<xsl :with-param name="min-courant" select="1000000"/> 
</xsl: call -tempi ate) 
</xsl:var1able> 

Surface mini = <xsl :val ue-of select="$surface-mini " />m2 
nature de la piece = <xsl :value-of select="local -name( 
//*[attribute::surface = 

concat($surface-mini, 'm2')])" /> 
</xsl : tempi ate) 



I Patterns de programmation 



IAPITRE 8 

|<xsl:template match="text( )"/> 
</xsl:stylesheet> 
Resultat 

Surface mini = lm2 

nature de la piece = mirador 

Somme des valeurs dun node-set 

En conservant le memefichier XM L, on peut maintenant calculer, pour chaque maison, 
la surface habitable. La fonction vaieur-o ne change pas; la fonction resuitato 
devientici une fonction sommeo, dont I e premier argument est I a somme dej a obtenue, et 
le deuxieme une nouvelle valeur a sommer. Le visiteur est implements sous le nom 



SurfaceHabitable.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl [Stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" vers1on="l.C 

<xsl:output method='text' encodings' ISO-8859-1' /> 



<xsl :templ ate name="valeur"> 

<xsl :param name="unSingleton"/> 

<xsl :variable name="result"> <!-- une surface --> 
<xsl : variable name="surface" 

select="$unSingleton/attribute::surface"/> 

<xsl :choose> 

<xsl:when test="$surface"> 

<xsl :value-of select="substring-before( Ssurface, 'm' )" /> 
</xsl:when> 
<xsl:otherwise> 

<xsl:value-of select="number( 'NaN' )" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl:variable> 

<xsl:copy-of select="$resul t" /> 
</xsl :template> 



<xsl :template name="Somme"> 
<xsl :param name="vl"/> 
<xsl :param name="v2"/> 

<xsl :variable name="result"> 
<xsl :choose> 

<xsl :when test="string($vl) = 'NaN' and string($v2) = ' 
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<xsl:value-of select="$vl" /> 
</xsl :when> 
<xsl:when test="string($vl) = 'NaN' "> 

<xsl:value-of select="$v2" /> 
</xsl :when> 
<xsl:when test="string($v2) = 'NaN'"> 

<xsl:value-of select="$vl" /> 
</xsl :when> 
<xsl: otherwise) 

<xsl:value-of select="$vl + $v2" /> 
</xsl :otherwise> 
</xsl :choose> 
</xsl:var1able> 

<xsl:copy-of select="$result" /> 
</xsl :templ ate> 



<xsl :template name="instancier-somme"> 
<xsl :param name="unNodeSet" /> 
<xsl:param name="somme-courante" /> 

<xsl :choose> 

<xsl :when test="$unNodeSet"> 

<xsl :cal 1 -template name="instancier-somme"> 
<xsl :with-param name="unNodeSet" 

select="$unNodeSet[position() > 1]"/ 

<xsl :with-param name="somme-courante"> 
<xsl :cal 1 -tempi ate name="Somme"> 
<xsl :with-param name="vl" 

select="$somme-courante"/> 

<xsl :cal 1 -template name="valeur"> 

<xsl :with-param name="unSingleton" 
select="$unNodeSet[position() = 1]"/ 
</xsl:call -template) 
</xsl:with-param> 
</xsl:call -template) 
</xsl :with-param> 
</xsl:call -template) 
</xsl:when> 

<xsl :otherwise> 

<xsl:value-of select="$somme-courante" /> 
</xsl :otherwise> 
</xsl :choose> 



</xsl :template> 



Patterns de programmation 



<xsl : tempi ate match="maison"> 

<xsl :variable name="surface-habitable"> 

<xsl :call -template name="instancier-somine"> 

<xsl:with-param name="unNodeSet" select=" .//*"/> 
<xsl :with-param name="somme-courante" select="0"/> 
</xsl : call -tempi ate> 
</xsl:variable> 

Maison id = <xsl : value-of select="@id"/> 
Surface habitable = <xsl : value-of select="$surface-habitable" />m2 /> 



</xsl :template> 



<xsl :templ ate match="text( )"/> 
7xsl:stylesheet> 

Resultat 

Maison id = 1 

Surface habitable = 136m2 /> 

Maison id = 2 

Surface habitable = 28m2 /> 

Maison id = 3 

Surface habitable = 57.5m2 /> 

Pattern n° 7 - Fonction renvoyant plusieurs resultats 

Motivation 

II peut arriver, que dans une fonction un peu compliquee, on ait plusieurs resultats a 
renvoyer, qui sontintimementlies du point devuealgorithmique. Cela veut dire que si 
I'on voulait renvoyer ces resultats un par un (un par appel), cela reviendrait a relancer 
plusieurs fois le meme calcul ou presque. Pour eviter cela, dans un langage comme C 
ou Java, on ecrit une fonction qui retourne une structure (C) ou un objet (Java). La 
question est done de voir comment ecrire en XSLT une fonction retournant (ou une 
action instanciant) I'equivalent d'une structure C. 

Realisation 

La solution est d'utiliser element source litteral a contenu calcule, instancie en TST 
(Temporary SourceTree, voir Temporary Source Tree, page 192) : 



ivoyant trois resultats x, y, z : 



<xsl :template r 
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<xsl : variable 



</y> 
<z> 

<xsl:value-of select-".. 
</z> 
</xsl:var1able> 

<xsl:copy-of select="$result" /: 

</xsl :template> 

<xsl : tempi ate match=" . . . "> 

<xsl variable name="a"> 

<xsl :call -tempi ate name="tn 
<xsl:with-param name=".. 
</xsl:call -template) 

</xsl:variable> 

<xsl:value-of select="$a/x"/> 
<xsl:value-of select="$a/y"/> 
<xsl:value-of select="$a/z"/> 

</xsl : tempi ate> 



Exemple 

On veut ici une fonction capable de detecter I e premier separateur d'une chaine de carac- 
teres, et de decouper cette chaine en trois morceaux : la partie situee avant le separateur, 
le separateur lui-meme, et la partie situee apres le separateur. On suppose qu'il y a deux 
separateurs possibles : I'espace, et I 'apostrophe. 

C'est pour cela qu'on doitecrire une fonction : s'il n'y avaitqu'unseul separateur a consi de- 

rer, onpourraitutiliserlesfonctionspredefinieSsubstring-beforeO et substring-after (). 

Nous allons ici reuti User la fonction index-of vuea la section Exemple, page 397 pour 
obtenir I 'index dechacun desdeux separateurs possibles ; le reste vient sans difficulte. 



separateurs.xsl 

<?xml version="1.0" i 
<xsl : stylesheet xmln: 



icoding="UTF-16"?> 

:xsl="http: //www. w3.org/1999/XSL/Transform" 



:output method^'text' encoding=' ISO-8 
:template name="index-of "> 
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sliparam name="aString"/> 
>1:param name="testString"/> 

;1 variable name="result"> 
<xsl :choose> 

<xsl :when test=" contains( SaString, StestString ) "> 
<xsl :variable name="string-Before"> 
<xsl:value-of 

select="substring-before( SaString, StestString )" /> 
</xsl:variable> 
<xsl :value-of select="l+string-length( Sstring-Before )" /> 

<xsl :otherwise> 



<xsl:copy-of select="$resul t" /> 
<sl :template> 

;1 rtemplate name="spl it-beforeAndAfter-firstSeparator"> 
-- separator = apostrophe ou espace --> 

<xsl :param name="stringToSpl it"/> 

<!-- stringToSplit is space-normalized --> 

<xsl variable name="indexOf-fi rstApos"> 
<xsl :call -template name="index-of "> 

<xsl :with-param name="aString" select="$stringToSpl it"/> 
<xsl :with-param name="testString" select=' "&apos ;" ' /> 
</xsl: call -tempi ate> 
</xsl:variable> 

<xsl : variable name="indexOf-f i rstSpace"> 
<xsl :call-template name="index-of "> 

<xsl:with-param name="aString" select="$stringToSpl it"/> 

<xsl:with-param name="testString" select= /> 

</xsl: call -tempi ate> 
</xsl:variable> 

<xsl :variable name="result"> 



<xsl:when test=" SindexOf-firstApos < $indexOf-fi rstSpace 
<before> 

<xsl:value-of select="substring( SstringToSpl it, 1, 
SindexOf-firstApos - 1 )" /> 
</before> 
<separator>'</separator> 
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ie-of select="substring( SstringToSplit, 

SindexOf-firstApos +1 )" /> 



<xsl :when test=" $indexOf-fi rstSpace < $indexOf-fi rstApos "> 
<before> 

<xsl :val ue-of select="substring( 

SstringToSplit, 1, 
$indexOf-fi rstSpace - 1 )" /> 
</before> 

<separator><xsl :text> </xsl :text></separator> 
<after> 

<xsl :value-of select="substring( 

SstringToSplit, 

$indexOf-fi rstSpace +1 )" /> 



<xsl:copy-of select="$result" /> 

</xsl :template> 

<xsl :variable name="complainteDuCharretier"> 

Pousser des charettes a longueur de journee reclame de l'energie ! 
</xsl:variable> 

<xsl :variable name="pendule"> 

L'heure exacte. 
</xsl:variable> 

<xsl : tempi ate match="/"> 

<xsl :cal 1 -tempi ate name="spl it-beforeAndAfter-f i rstSeparator"> 
<xsl:with-param name="stringToSpl it" 
select="normalize-space($complainteDuCharretier)"/> 
</xsl : call -tempi ate> 
</xsl:variable> 

<xsl :val ue-of select^ "normal ize-space($complainteDuCharretier)"/> 
before = <xsl : value-of select="$spl itl/before"/> 
separator = "<xsl :value-of select="$spl itl/separator"/>" 
after = <xsl :val ue-of select="$spl itl/after"/> 

<xsl. -variable name="split2"> 

<xsl :cal 1 -tempi ate name="spl it-beforeAndAfter-f i rstSeparator"> 
<xsl:with-param name="stringToSpl it" 
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select="normalize-space($pendule)"/> 
</xsl: call -tempi ate> 
</xsl:variable> 

<xsl :text> 

</xsl:text> 

<xsl :value-of select="normal ize-space($pendule)"/> 
before = <xsl :value-of select="$spl it2/before"/> 
separator = "<xsl :val ue-of select="$spl it2/separator"/>" 
after = <xsl : value-of select="$spl it2/after"/> 

</xsl :template> 

<xsl :template match="text( )"/> 

</xsl:stylesheet> 

Resultat 

Pousser des charettes a longueur de journee reclame de 1'energie ! 
before = Pousser 

after = des charettes a longueur de journee reclame de 1'energie 

before = L 
separator = 



Pattern n° 8- Utilisation dune structure de donnees auxilaire 
Motivation 

XSLT est unlangagedont la description ne fait jamais appel defaconevidentea la notion 
de structure de donnees manipulable par telle ou telle instruction. En Java ou d'autres 
langages, il y a touj ours touteunepanopliede structures possibles (tableaux, listes, piles, 
etc.), maispasenXSLT. 

X SLT ne connait que la notion d'arbre XML; done, en acceptant la structure d'arbre comme 
structure de donnees uni versel le, on peut se raccrocher aux branches, et parveni r a ses fins. 
En effet, un arbreXM L, en tantqueTST accroche a une variable peut jouer leroled'une 
structure de donnees (non modifiable, comme d'habitude en XSLT) : une fois I'arbre 
construit dans une variable, on peut utiliser des expressions XPath pour le parcourir et 
extraireles informations utiles. Et si cetarbreXM L estun peu trap vol umineux ou com- 
plexe pour que les recherches y soient efficaces, rien n'empeche d'y indexer certaines 
valeursparunecle(xsi : key). 
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Exemple 



Dans cet exemple, nous allons montrer comment mettre en ceuvre une structure de don- 
nees indispensable au traitement. II s'agit de renumeroter sequentiellement des identi- 
fiants numeriques de pages d'une presentation video-projetable specifiee en XM L. Un 
exemple abreged'un tel fichierXML pourrait etre celui-ci : 

presentation.xml 

<?xml version="1.0" encoding="UTF-16" ?> 



<pageDeTitre id="CoursXML.l" next="CoursXML.2"> 

<titrePresentation>Comprendre XML et XSL</titrePresentatic 

<groupeAuteurs> 

<auteur>Philippe Drix</auteur> 
<societe>OBJECTIVA</societe> 
</groupeAuteurs> 
</credit> 
</pageDeTitre> 



<pageStandard id="CoursXML.2" prev="CoursXML.l" next="CoursXML.3"> 
<t1tre level="l" id="CoursXML.2.Deroulement"> 
Deroulement du Cours</titre> 



</pageStandard> 



id="CoursXML.3" prev="CoursXML.2" next="CoursXML.4"/> 



<pageStandard id="CoursXML.4" prev="CoursXML.3" next="CoursXML.4 
<t1tre level="l" id="CoursXML.4._XMLgeneral"> 
XML - Generality </titre> 



</pageStandard> 



<pageStandard id="CoursXML.4.1" prev="CoursXML.4" next="CoursXML.4 
<t1tre level="2" id="CoursXML.4.1._Langagesdebalisage"> 
Les langages de balisage </titre> 



<bloc> 

<figure src="ArbreXML_l" id="fig:ArbreXML_l.CoursXML.4.1"> 
<captionFigure> 

Structure arborescente d'un document XML bien forme 
</captionFigure> 
</figure> 
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</bloc> 
</pageStandard> 



<pageStandard id="CoursXML.4.2" prev="CoursXML.4.1" next="CoursXML.5"> 
<t1tre level="2" id="CoursXML.4.2._AQuoiSertXML"> 
A quoi peut servir XML ? </titre> 



</pageStandard> 



<pageStandard id="CoursXML.5" prev="CoursXML.4.2" next="CoursXML.6"> 
<titre level="l" id="CoursXML.5._StructuredocumentXML"> 
Structure d'un document XML </titre> 



<bloc> 

Ces blocs juxtaposes ou imbriques 
<cf Figure cf="fig:ArbreXML_l.Cour 
comme tout document XML. 

</bloc> 


forment un 
sXML.4.1"/> 


</pageStandard> 










<pageStandard id 
<titre level 
Grammaire d' 
</titre> 


= "Cou 
un do 


rsXML.6" prev="Cours 
d="CoursXML.6._DTD 
cument XML (DTD) 


XML. 5 


next 


</pageStandard> 











<pageFin id="CoursXML.7" prev="CoursXML.6" /> 






De temps en temps, on aj oute ou suppri me des pages entre deux, ce qui fait que les nume- 
ros d'identifiant des pages finissent par etre assez eloignes de I'ordre naturel. La renu- 
merotation consiste a retablir I'ordre naturel, sachant qu'il y a des repercussions sur 
d'autres identifiants, comme ceux des titres, ou des figures, et par voie de consequence, 
les references aux figures. 

L e resu I tat attend u de la transformation XSLT est done celui-ci : 



<?xml version="1.0" encoding="ISO-E 
<presentation> 



<pageDeTitre id="CoursXML.l" next="CoursXML.2"> 
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<titrePresentation>Comprendre XML et XSL</titrePresentatior 
<credit> 

<groupeAuteurs> 

<auteur>Philippe Drix</auteur> 
<societe>OBJECTIVA</societe> 
</groupeAuteurs> 
</credit> 
</pageDeTitre> 



<pageStandard id="CoursXML.2" prev="CoursXML.l" next="CoursXML.3"> 
<t1tre level="l" id="CoursXML.2._"> 
Deroulement du Cours</titre> 



</pageStandard> 



id="CoursXML.3" prev="CoursXML.2" next="CoursXML.4"/> 



<pageStandard id="CoursXML.4" prev="CoursXML.3" next="CoursXML.5"> 
<t1tre level="l" id="CoursXML.4._XMLgeneral"> 
XML - Generality </titre> 



</pageStandard> 



<pageStandard id="CoursXML.5" prev="CoursXML.4" next="CoursXML.6"> 
<t1tre level="2" id="CoursXML.5._Langagesdebalisage"> 
Les langages de balisage </titre> 

<bloc> 

<figure src="@src" id="fig:ArbreXML_l .CoursXML.5"> 
<captionFigure> 

Structure arborescente d'un document XML bien forme 
</captionFigure> 
</figure> 
</bloc> 

</pageStandard> 



<pageStandard id="CoursXML.6" prev="CoursXML.5" next="CoursXML.7"> 
<t1tre level="2" id="CoursXML.6._AQuoiSertXML"> 
A quoi peut servir XML ? </titre> 



</pageStandard> 



<pageStandard id="CoursXML.7" prev="CoursXML.6" next="CoursXML.£ 
<titre level="l" id="CoursXML.7._StructuredocumentXML"> 
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Structure d'un document XML </titre> 

<bloc> 

Ces blocs juxtaposes ou imbriques torment un arbre 
<cf Figure cf="fig:ArbreXML_l.CoursXML.5"/> 
comme tout document XML. 

</bloc> 

</pageStandard> 

<pageStandard id="CoursXML.8" prev="CoursXML.7" next="CoursXML.9 
<titre level="2" id="CoursXML.8._DTD"> 
Grammaire d'un document XML (DTD) 
</titre> 

</pageStandard> 

<pageFin id="CoursXML.7" prev="CoursXML.6"/> 



</presentation> 

Le probleme est done ici de garder en memoire une table de correspondance entre les 
anciens id et les nouveaux.Ayant une telle table, achaquefoisqu'on a un id a changer, 
on va chercher le nouvel id correspondant a I'ancien, ce qui nous permet de former une 
nouvelle chaine de caracteres a parti r de ce nouvel id. 

Par exemple, ayant I'identifiant fig : ArbreXML_i.coursXML.4.i, on en extrait cours- 
xml.4.1 ; la table nous donne la correspondance de cet identifiant avec 5, ce qui nous 
permet de former I'identifiant n fig:ArbreXML_i.coursXML.5". 

De meme, a parti r de coursXML.4. 1, on obtient a nouveau 5, done a parti r de 5+1 et de 5-1, 
on forme respectivement les identifiants next (coursXML.6) et prev (coursXML.4). 

La realisation de cette table consiste a creer un arbre XM L contenant toutes les paires 
(ancien id , nouvel id) conservees par exemple en tant qu'attributs d'un element 
<page> qui sera repete autant de fois qu'il y a de pages declares dans la <presentation> 

(ce qui indut tOUteS les SOrteS de pages: <pageDeTitre>, <plan>, <pageStandard>, 
<pageFin>). 

On peut done faire cela de cette maniere : 
Constitution de la table de correspondance 



5lect="@id"/></xsl: attribute) 



<xsl: van able 


nam 


e="lesPages"> 




<pages> 










<xsl:for- 


aach 


select= 


"/pre 


sentation/*"> 


<page 










<xsl: 


attr 


bute na 




d"Xxsl :value- 


<xsl: 


attr 


bute na 




ewld"> 
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<xsl:value-of select="position()"/> 
</xsl:attribute> 
</page> 
</xsl:for-each> 

</xsl:variable> 

Cette variable sera une variable globale, ce qui veut dire qu'elle sera evaluee avec le 
noeud racinecommenceud contexte; avec lefichier presentation. xmi montreci-dessus, 
I'arbre genere sera lesuivant: 

Arbre genere lors de 1 'evaluation de cette variable 

<pages> 

<page id="CoursXML.l" newld="l'7> 

<page id="CoursXML.2" newId="2"/> 

<page id="CoursXML.3" newld="3'7> 

<page id="CoursXML.4" newld="4'7> 

<page id="CoursXML.4.1" newld="5'7> 

<page id="CoursXML.4.2" newld="6'7> 

<page id="CoursXML.5" newld="7'7> 

<page id="CoursXML.6" newld="8'7> 

<page id="CoursXML.7" newld="9'7> 
<pages> 

On peut tout de suite mettre au point un model e nomme qui permettra d'instancier le 
newiDconnaissantl'id : 

Arbre genere lors de devaluation de cette variable 

<xsl :template name='instancier-newID'> 
<xsl:param name='oldId'/> 
<xsl :value-of select="$lesPages/pages/page[ 

attribute: :id = $oldId 
]/attribute::newId" /> 
</xsl :template> 

Remarque 

On utilise ici le faitqu'une variable contenantunTST est implicitement convertie en node-set lorsqu'elle estrefe- 
rencee. On rappelle que ceci n'estpas conforme au standard XSLT 1.0, mais que c'est une proposition qui sera 
selon toute vraisemblance integree au standard XSLT 2,0. Voir a ce sujet la section Operations sur un TST 
(XSLT 1.1 ou plus), page 198. 

Ceci etant, on quitte maintenant le domaine du pattern pour entrer dans le specifique, 
puisqu'il s'agit de realiser la transformation demandee (le pattern ne concerne que la 
facon de realiser une structure de donnees). Mais en fait, si on quitte le domaine du pat- 
tern, c'est pour y revenir aussitot, carcequ'on a a faire maintenant est une copiepresque 
conforme du document (pour s'enconvaincre, il suffitde comparer le document source et 
le resultat attendu : au premier coup d'ceil, on ne voit pas de difference, car seules les 
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parties numeriques des identifiants changent d'un document a I 'autre). Or une copie 
presque conforme, c'est un des patterns de transformation, que nous verrons done dans le 
chapitrequi leurestconsacre. 

Si I 'on s'interessedansun premier temps uniquement a la facon demodifier I esattributs 
d'une <pagestandard>, on va commencer par ecrire une regie qui exploite cette table de 
correspondanceen utilisantlemodelenomme instancier-newiD : 



Modification des attributs d'une pageStandard 



<xsl :template match='pageStandard'> 
<pageStandard> 

<xsl :variable name="NoSeq"> 

<xsl :call -template name='instancier-newID') 

<xsl:with-param name='oldId' select="@id" /> 
</xsl: call -tempi ate> 
</xsl:variable> 

<xsl [attribute name="id")CoursXML.<xsl :value-of select="$NoSeq" /> 

</xsl:attribute> 

<xsl attribute name="prev")CoursXML.<xsl :value-of select="$NoSeq - l"/> 

</xsl: attribute) 

<xsl attribute name="next")CoursXML.<xsl :value-of select="$NoSeq + l"/> 

</xsl: attribute) 

</pageStandard> 
</xsl :templ ate> 

On aura exactement le memetraitement pour la page speciale <pi an>, et des regies voisines 
pour une <pageDeTi tre> et une <pageFi n>, ce qui nous amene a ceci : 

Modification des attributs d'une pageStandard ou d'un plan 

<xsl :template match='pageStandard | pi an ' > 

<xsl: element name="{local-name(.)}"> 

<xsl:variable name="NoSeq"> 

<xsl :call-template name='instancier-newID') 

<xsl:with-param name='oldId' select="@id" /> 
</xsl:call -template) 
</xsl:variable> 

<xsl [attribute name="id")CoursXML.<xsl :value-of select="$NoSeq" /> 

</xsl attribute) 

<xsl [attribute name="prev")CoursXML.<xsl : value-of select="$NoSeq - l"/> 

</xsl attribute) 

<xsl [attribute name="next")CoursXML.<xsl :val ue-of select="$NoSeq + 1"/) 

</xsl [attribute) 

<xsl :apply-templates/> 
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</xs1 :element> 
</xsl :template> 

Modification des attributs d'une pageDeTitre 

<xsl :template match='pageDeTitre'> 

<!-- idem sans 1'attribut prev --> 
</xsl :template> 

Modification des attributs d'une pageFin 

<xsl :template match='pageDeTitre'> 

<!-- idem sans 1'attribut next --> 
</xsl :template> 

Maisil ne suffit pas derecopier une page (i.e. un element du genre page) en secontentant 
de generer des attributs modifies: encore faut-il copier ses enfants directs comme 
<titre> ou <bioc>, ce qui pourra etre fait par des regies dediees a chacun de ces ele- 
ments. C'est pourquoi le modele de transformation se termine par un <xsi:appiy- 
tempi ates/>, qui va relancer les regies concernees. 

Mise en place de regies specifiques pour les enfants d'une page 

<xsl : tempi ate match='titre'> 



</titre> 
</xsl :template> 

<xsl : tempi ate match='f igure'> 
<figure src="@src"> 

</figure> 
</xsl :template> 

<xsl :template match='cf Figure'> 
<cfFigure> 

</cfFigure> 
</xsl:template> 

Dans chacune de ces regies, on effectue un traitement similaire a celui d'une page pour 
former et generer les nouvelles valeurs d'attributs identifiants. 
Le probleme est maintenant de voir comment I'ensemble s'articule. Le processus de 
traitement demarresur la racine, pour laquelle aucune regie n'est prevue. La regie par 
defaut va done s'appliquer, cequi va produire un node-set necontenant que I'element 
<presentation>, et relancer toute la mecanique sur ce node-set. A nouveau, la regie 
par defaut sera selectionnee, car il n'y a aucune regie specifique pour une <presenta- 
tion>. M ais cettefois, ce n'est pas souhaitable, car I'element <presentation> ne peut 
pas etre traite par defaut: il faut le recopier. Plus generalement tout element pour 
lequel une regie specifique n'existe pas (typiquement, il s'agit des elements qui n'ont 
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pas d'attributs concerned par la renumerotation, ou pas d'attribut du tout) doit etre 
traite non pas pardefaut, mais par une regie qui va lerecopier sans modification. II faut 
done avoir une regie « ramasse-tout » de recopie (pour des explications comple- 
mentaires concernant cette regie, voir le pattern « Copie non conforme », a la section 
Pattern n° 10 -Copie non conforme, page 443) : 



Regie de recopie i 



<xsl :template match='* 



|<xsl:apply-templates select='@*[node( ) ' /> 
</xsl :copy> 
</xsl :template> 

Voici done maintenant le programme complet : 

renumeroter.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 
version = "1.1"> <!-- compatibility Saxon 6.5 --> 



<xsl:output method='xml ' encoding^' ISO-8859-1' /> 
<xsl :variable name="lesPages"> 

<xsl :for-each select="/presentation/*"> 

<page> 

<xsl attribute name="id"Xxsl :val ue-of select="@id"/> 

</xsl:attribute> 

<xsl :attribute name="newld"><xsl :val ue-of select="positiot 

</xsl:attribute> 

</page> 
</xsl:for-each> 
</pages> 

</xsl:variable> 



<xsl :template name=' instancier-newID'> 
<xsl:param name='oldId'/> 
<xsl :value-of select="$lesPages/pages/page[ 

attribute: :id = Soldld 
]/attribute::newId" /> 
</xsl :template> 

<xsl :template match^'pageStandard ] plan'> 

<xsl :element name="{local -name( . )}"> 

<xsl : variable name="NoSeq"> 

<xsl : cal 1 -template name='instancier-newID' 
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<xsl:with-param name='oldId' select="@id" /> 
</xsl: call -tempi ate> 
</xsl:variable> 

<xsl: attribute name="id">CoursXML.<xsl :value-of 

select="$NoSeq" /></xsl :attribute> 
<xsl attribute name="prev">CoursXML.<xsl : value-of 

select="$NoSeq - l"/X/xsl :attribute> 
<xsl attribute name="next">CoursXML.<xsl : value-of 

select="$NoSeq + 1" /></xsl :attr1bute> 

<xsl :apply-templates/> 
</xsl: element) 
</xsl :template> 

<xsl :template match='pageDeTitre'> 

<xsl : element name=" {local -name( . )}"> 
<xsl:variable name="NoSeq"> 

<xsl :cal 1 -template name='instancier-newID'> 

<xsl:with-param name='oldId' select="@id" /> 
</xsl:call -tempi ate) 
</xsl: van" able) 

<xsl [attribute name="id">CoursXML.<xsl :value-of 

select="$NoSeq" /></xsl attribute) 
<xsl attribute name="next">CoursXML.<xsl : value-of 

select="$NoSeq + 1" /X/xsl attribute) 

<xsl :apply-templates/> 
</xsl: element) 
</xsl :templ ate> 

<xsl : tempi ate match='pageFin'> 

<xsl : element name=" {local -name( . )}") 
<xsl:variable name="NoSeq"> 

<xsl: call -tempi ate name='instancier-newID'> 

<xsl:with-param name='oldId' select="@id" /> 
</xsl:call -tempi ate) 
</xsl:variable> 

<xsl: attribute name="id">CoursXML.<xsl :value-of 

select="$NoSeq" /X/xsl attribute) 
<xsl [attribute name="prev">CoursXML.<xsl :value-of 

select="$NoSeq - 1" /X/xsl attribute) 

</xsl: element) 

</xsl :templ ate> 

<xsl : tempi ate match= ' ti tre ' > 
<titre> 
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;l:template match='figure'> 

<figure src="@src"> 

<xsl : variable name="NoSeq"> 

<xsl : call -tempi ate name='instancier-newID'> 
<xsl :with-param name='oldId' 

select="ancestor: :pageStandard/attribute: :id"/> 
</xsl :call -template> 
</xsl:variable> 

<xsl : variable name="texteID" select='substring-before(@id, ".")' /> 

<xsl attribute name="id"> 

<xsl:value-of select="$texteID" /> 

<xsl :text>.CoursXML.</xsl :text> 

<xsl :value-of select="$NoSeq" /> 
</xsl :attribute> 

<xsl :apply-templates/> 
</figure> 
<sl :template> 
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<xsl : tempi ate match='cf Figure '> 

<cfFigure> 

<xsl variable name="NoSeq"> 

<xsl :cal 1 -template name='instancier-newID'> 
<xsl :with-param name='oldId' 

select="substring-after(@cf , ' . ' )"/> 
</xsl:call -template) 
</xsl:variable> 

<xsl :variable name="texteID" select='substring-before(@cf, ".")' /> 

<xsl: attribute name="cf"> 

<xsl:value-of select="$texteID" /> 
<xsl :text>.CoursXML.</xsl :text> 
<xsl :value-of select="$NoSeq" /> 
</xsl: attribute) 
</cfFigure> 
</xsl :template> 



<xsl :template match='*'> 

<xsl :copy> 

<xsl :apply-templates select='@*|node( ) ' /> 

</xsl :copy> 
</xsl :template> 

</xsl: stylesheet) 

Ce programme fonctionneavec Saxon, qui accepte I es evolutions prevues dans leW3C 
Working DraftXSLT l.l.Avec un processeur qui s'entientau standard XSLT 1.0, il faut 
uti I i ser une foncti on d'extensi on pour converti r expl i ci tement en node-set leRTF renvoye 
par la reference a la variable l esPages ; les modifications concernent la declaration de la 
feuillede style, etlemodelenomme instancier-newiD. Leresteestinchange. 

Modifications pour utiliser la fonction d'extension nodeset 

<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 
xmlns:xalan="http://xml .apache.org/xalan" 
exclude- res ult-prefixes="xa Ian" 



lesPages)/pages/page[ 

:id = $oldId]/attribute::newId" /> 

1 1 pourra etre interessant de reveni r a ce programme apres avoir vu le pattern « Copie non 
conforme», a la section Pattern n° 10 -Copie non conforme, page 443. 
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Pattern n° 9 - Identite de noeuds et node-set de valeurs 
toutes differentes 



Motivation 



II peut arriver que I'on ait a tester I 'identite de deux noeuds pour savoir si ce sont les 
memesou non. 

II y a alors deux choses a savoir : la premiere, c'est ce que signifie I 'identite de deux 
noeuds, etcommentunesituationouil y a identite peut seprodui re; ladeuxieme, c'est de 
savoir comment s'y prendre pour realiser un tel test. 

Maisavantcela, il est i ndi spensabl e, arrive ace point, debi en expliciter lerapportqu'il y 
a entre les node-sets que I'on manipule au travers d'expressions XPath et les noeuds 
qu'ilscontiennent. On seplacedans lecas simple ou I'on a un arbreXM L (I'arbreXM L 
du document source), mais pas de variable attachee a un TST, ni de document XML 
secondaire accessible par la fonction document ). 

Supposons maintenant que nous ayons constitue deux node-sets, grace a deux expressions 
XPath quelconques. Quecontiennentexactementces node-sets? 

Certainement pas une copie des noeuds de I'arbre XML, car le nombre de noeuds total 
dans le systeme ne varie pas au cours de I'execution (tout au moins dans I'hypothese 
explicitee ci-dessus) : ce nombre est eel ui del'arbresourceXML. 

Sont-ce alors les noeuds originaux ? 

Pas plus, car cela voudraitdirequesi un noeud etaitcontenu dans un certain node-set, il 
ne serait plus disponible pour faire partie d'un autre node- set, ce qui est absurde. 

La reponse est d'ordre mathematique : en mathematiques, les ecritures comme x, y, N, 
designentdesobjetsmathematiquesqui peuplent I 'uni vers mathematique, etqui existent 
chacun en un seul exemplaire. II n'y a pas plusieurs nombre un, il n'y en a qu'un ; mais 
il y a une infinite d'ecrituresdesignantce nombre, parmi lesquelles, 1, 0+1, 2/2, x tel que 
x solution del 'equation x = 1, y tel que y solution del 'equation y = 1, etc.Avec les deux 
dernieres ecritures, on peut dire que x = y, parce que x et y sont deux ecritures qui 
designent le meme nombre (un, en I 'occurrence). 

La meilleure representation qu'on puisse se faire d'un node-set est basee sur la meme 
idee: un node-set contient des choses qui referencent les noeuds de I'arbreXM L source, 
mais pas les noeuds eux-memes, ni encore moins une copie. Cela s'implemente evidem- 
ment sous la forme depointeurs, mais i I est a noter que I e standard XSLT ne pari e jamais 
de pointeurs, qui sont des notions d'implementation, et seraient plutot mal venues dans 
une specification. La figure 8-1 donne une representation graphique du lien entre un 
node-set et les noeuds qu'il contient. 

Imaginons maintenant que I'on veuille constituer un node-set contenant les surfaces des 
pieces du RDC (toujoursen sereportantalafigure8-l). 
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Deux node-sets partageant un naud commun. 



On pourraitetretente d'ecrire : 

Node-set des surfaces 

<xsl variable name="x" select="/mais< 



n/RDC/Vattribute: :surface"/> 



Cequi n'est pas forcement faux. M ais est-ce bien ce qu'on voulait ? Si le butetaitd'obte- 
nir un node-set ne contenant que des surfaces differentes les unes des autres (apres tout, 
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un ensemble necontientbi en que des elements differents I es uns des autres, non ?), c'est 
rate. Le node-set $x contient trois elements, correspondant aux surfaces 40m 2 , 40m 2 , 
15m 2 . Mors? Quesepasse-t-il ? 

C ' est tres si mple a voirgraphiquement (voir figure 8-2). 




— text — 




- text -. 


Evier inox. 




Lavabo. 


Mobilier 




Cumulus 


encastre. 




200L. 



text 

Chemineeen 

pierre. 

Poutresau 

plafond. 

Carrelageterre 

cuite. 

Grande baie 

vitree 



Figure 8-2 

Un node-set d 'attribute. 
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Le node-set ainsi constitue a bien trois elements, parcequ'il y a bien trois attributs dans 
I'arbre XML. Que deux d'entre eux aient la meme valeur textuelle ne change rien a 
I'affaire: il y a trois attributs, etrien ne peut detrui re cette certitude. 

Nous avons done repondu a la premiere question, qui etait de savoir ce qu'est la notion 
d'identite : deux noeuds d'un node-set sont identiques s'ils referenced le meme nceud de 
I'arbre XML. 

M ais la deuxieme question reste en suspens : comment faire pour tester I'identite de deux 
noeuds ? Et nous venons d'ajouter une question supplemental re : comment faire pour consti- 
tuerun node-sets de surfaces, e'est-a-direun node-set de noeuds de valeurs toutes differentes? 

C 'est ce que nous al Ions voi r mai ntenant. 

Realisation 

Tests d'identite 

II n'y a que deux moyensderealiserun test d'identite en XSLT : soit on emploie I 'ope- 
rates " | - (barre verticale) qui realise I'union ensembliste de deux node-sets, soit on 
utilise la fonction predefinie generate-ido, qui comme son nom I'indique, retourne 
un identifiant pour le noeud qui lui est transmis (explicitement, ou impiicitement si 
e'est I e nceud contexte). 

Pour simplifier et se concentrer sur le principe, on peut supposer que le test d'identite va 
s'appliquer a deux node-sets NS1 (ne contenant qu'un seul noeud nl) et NS2 (ne cove- 
nant qu'un seul noeud n2). Le test d'identite des noeuds nl etn2 peut alorsetre applique 
aux node-sets NS1 et NS2, chose indispensable en XSLT puisqu'on ne peut manipuler 
que des node-sets. 

Tests d'identite 

count( $NS1 | $NS2 ) = 1 

generate-id( $NS1 ) = generate-id( $NS2 ) 

Le deuxieme test est direct: generate-ido renvoieun identifiant sur le premier noeud du 
node-set qui lui est transmis; la specification de cette fonction garantit que si lesidentifiants 
sont egaux (en tant que chaines de caracteres), alors les noeuds transmis sont confondus. 
Le premier test est un peu plustordu, mais constitue une expression XPath idiomatique: 
si NS1 et N52, deux singletons, ontunereunion dontle cardinal reste egal a 1, e'estqu'ils 
contiennent le memeelement (au sens de I'identite que nous avons vu plus haut), e'est-a- 
dire qu'ils partagent le memeelement (voir figure 8-1 ). 

Dans la meme veine, on a le test d'appartenance vu a la section Appartenance et test 
d'inclusion, page 44 ($N representeun node-set ne contenant quel e noeud dont I'appar- 
tenance a $N S est a tester) : 

Tests d'appartenance 
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Node-set de valeurs toutes differentes 

Methode du preceding-sibling 

Pour le node-set de surfaces, c'est un peu plus complique. En toute logique, il fau- 
drait exprimer le node- set sous forme d'une expression X Path qui dise quelque chose 
du genre : 

/maison/RDC/*/attribute::surface[ 

la valeur textuelle de . n'existe pas deja dans le node-set en construction 

Remarque 

Ne pas oublier que dans cette expression, le « . » represente le nceud contexte de revaluation du predicat : c'est 
done touratourchacun des nceuds de I'ensemble /maison/RDC/*/attribute: : surf ace. Pour chacun deces 
noeuds, on teste si sa valeur textuelle etc., etc. : si oui, on garde le nceud dans le node-set en construction, 
sinon, on le rejette. 

Malheureusement, une telle expression n'est pastraduisibleenXPath, parcequ'il n'y 
a aucun moyen de referencer le node-set en cours de construction. II faut contourner 
le probleme en trouvant une facon de dire la meme chose sans parler de node-set en 
construction : 

/maison/RDC/*/attribute::surface[ 

la valeur textuelle de . n'existe pas deja dans un certain node-set NS 
I 3 

Cette expression est cette fois traduisible en XPath, maisle probleme resteentier: com- 
ment trouver I e node-set NS ? En tri chant un peu, on peut arriver a en trouver un. Eneffet 
les nceuds portant les attributs surface sont tous des enfants d'un element unique <rdc> 
(si tantestqu'il n'y ait pas plusieursrez-de-chaussee dans une meme maison, etqu'il n'y 
ait pas plusieurs elements <maison> accroches a la racine). 

Done dans devaluation du predicat ci-dessus, le nceud contexte sedeplacedeproche en 
proche sur des nceuds surface qui sont portes par des elements de I 'axe chi id::*, done 
des elements qui sont selectionne's dans I 'ordre de lecture du document. 

La solution qu'on peut alors tenter demettre en ceuvredecouledela remarquesuivante: 
puisque les elements sont selectionnes dans I 'ordre de lecture du document, les elements 
deja traites dans I 'evaluation du predicat sont ceux qui se trouvent dans le node-set 
preceding-sibling: :* relatif a I 'element en cours de test. Avec cette idee, la pseudo- 
expression X Path ci-dessus devient : 

/maison/RDC/*[ la valeur textuelle de ./attribute: :surface n'existe pas deja dans 
preceding-sibl ing: :*/attribute: : surface ] /attribute: : surface 

Ce qui donne, en bon X Path : 

Creation d'un node-set de surfaces toutes differentes 

/maison/RDC/*[ not( ./©surface = preceding-sibl ing: :*/@surface ) ]/@surface 



Pattern n 9 - Identite de noeuds et node-set de valeurs toutes differentes 

Chapitre 8 

La encore, cette expression, quoiqu'un peu complexe, est assez idiomatique. On la 
retrouve sous diverses formes, notamment dans les transformations XSLT comportant 
des regroupements (voir Pattern n° 14-Regroupements, page 474). 

A chaque fois, on exploite la propriete selon laquelle un element se trouvant dans 
preceding-sibling: :* se trouve aussi necessairement dans le node-set en cours de 
construction, ce qui donne une approximation du node- set en cours de construction. 

A noter que la construction d'un node-set d'au plus n elements, avec ce genre de predi- 
cat, est une operation pouvant demander n(n-l)/2 comparaisons dans les cas les moins 
favorables, parcequeplusonavance, plusil y adu mondederriere, etdonc plus I'explo- 
ration de preceding-sibling::* estlongue. 

Methode du regroupement parcle 

U ne autre methode existe pour etablir un tel node-set. Cette methode a ete inventee par 
Steve M uench, de la societe Oracle (quelqu'un detresactif dans ledomainedeXSLT). 
L'idee est de partir de node-sets obtenus par la fonction keyo, appliquee a une cle 
regroupant les valeurs identiques, comme indique sur la figure 8-3. 

Si, dans la situation schematisee par la figure 8-3, on appelle la fonction keyo avec 
« 40m 2 » comme deuxieme argument, on obtient en retour un node-set d'attributs dont 
lesvaleurstextuellessonttoutesegalesa«40m 2 »; de plusil est certain que cegroupede 
surfaces contient toutes les surfaces de« 40m 2 » (il n'en manque aucune). 

Pour obtenir le node-set des surfaces toutes differentes, il suffit done de prendre un et 
un seul nceud dans chaque groupe de surfaces, e'est-a-dire le premier nceud de chaque 
groupe (s'il y a un premier, pourquoi pas lui ? et s'il n'y en a pas, e'est que le groupe 
est vide). 
On part done d'une declaration de cle, comme ceci : 

<xsl:key na 

Ensuite, on veut recolter des surfaces ; on va done ecrire : 

//attribute: surface 

cequi recolte toutes les surfaces. Un nceud attribute dece node-set ne doit etre garde 
que s'il s'identifieau premier nceud attribute renvoye par : 

key( 'groupesdeSurfacesParValeurs' , la valeur textuelle du nosud teste) 

Or la valeur textuelle du nceud teste est tout simplement la valeur textuelle de "." , 
puisqu'on est en train d'etablirun predicat: 

key( 'groupesdeSurfacesParValeurs' , . ) 

Le premier nceud du node-set renvoye par cette expression est done : 

key ('groupesdeSurfacesParValeurs' , .)[1] 
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Figure 8-3 

Regroupement de valeurs par d<? 
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Ce qui donne un predicat de la forme : 

//attribute: :surface[ 

. s'identifie a ( key( 'groupesdeSurfacesParValeurs ' , .)[1] ) 
] 

On est done maintenant ramene a un probleme d' identification (ou de test d'identite), 
probleme que I'on sait resoudre (voir ci-dessus) ; nous choisissons ici la methode par 
appel delafonction generate-ido : 

Creation d'un node-set de surfaces toutes differentes 

//attribute: :surface[ 
generate-id( ) = 
generate-id( 

keyC groupesdeSurfacesParValeurs', .)[1] 

] 
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Les patterns de transformation, a I 'inverse des patterns de programmation, constituent 
des buts en soi. Ceci ne veut pas dire qu'une feuille de style n' aura jamais d'autre but 
que eel ui misenoeuvreau traversdu pattern, mais plutot qu'unefeuille de style qui ne 
mettrait en ceuvre qu'un de ces patterns pourrait tout de meme faire quelque chose de 
sense. 

Comme pour les patterns de programmation, il ne s'agit pas ici de constituer un catalo- 
gue exhaustif. 1 1 est meme probable que la mise en evidence de nouveaux patterns se fera 
plus pour des patterns de transformation que pour des patterns de programmation. 

Pattern n° 10 - Copie non conforme 

Motivation 

Nous avonsdonne beaucoup d'exemples (voir Se'mantique, page 325) de I 'utilisation de 

I 'instruction xsi :copy, mais peut-etreavez vouspensequ'ilsn'etaient pas forcementtres 
utiles dans la pratique. En effet, aquoi sertderecopier a I'identique un document XM L 
vers un autre ? 

En fait, cela n'estpassi inutile que cela, caravecxsi :copy, il est possible deregler fine- 
ment I e moment ou la copie s'arrete pour laisser place a la vari ante. II estainsi possible 
d'obtenir une copie d'un fragment X M L, qui n'est pas exactement identique a I 'original, 
mais legerement differente. 

Par ailleurs, si nous avons donne beaucoup d'exemples, e'etait pour illustrer les diffe- 
rente cas possibles de comportement de I 'instruction xsi :copy en fonction du type de 
nceud courant. Maisil est possible d'ecrire une copie generique, qui marche dans tousles 
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Done, avant de voir une copie non conforme, voyons tout d'abord une copie conforme 
generique. II evident, par ailleurs, qu'une copie conforme se fait tres simplement avec 
xsi :copy-of ; mais pour evoluer vers une copie non conforme, il faut parti rd'une copie 
conforme utilisantxsi :copy etnon pasxsi :copy-of. 

Ensuite nous verrons I'interet qu'il peut y avoir a obtenir un document presque identique 
al'original, et comment realisercela. 

Copie conforme generique 

Commencons par considerer la regie suivante : 

<xsl :template match="*"> 

I<xsl:copy> 
<xsl :apply-templates/> 
</xsl:copy> 
</xsl :templ ate> 

C'est une regie recursive, puisque elle s'applique a tout element, et qu'elle sera done 
selectionnee pour traiter les nceuds rassembles en une nouvelle liste par <xsi :appiy- 

templ ates/>. 

Une des premieres choses dont il faut done s'inquieter, c'est de savoir si la recursion a 
des chances de s'arreter, ou si elle est infinie. Clairement, la recursion s'arrete si la liste 
de nceuds constitute par <xsi :appiy-tempiates/> est vide. Cela peut-il se produire? 
Oui, puisque les nceuds en question sont les enfants directs du nceud courant. Si done le 
nceud courant est unefeuillede I 'arbre XML, la recursion s'arrete. 

La regie montreeci dessusexprimedonc la definition recursive suivante : 

La recopie d'un element, c'est : 

la copie de cet element 

a laquelle on accroche : 

- la recopie du premier enfant 

- la recopie du deuxieme, 

- la recopie du dernier enfant, 

- ou rien s'il n'y a pas d'enfant. 

Ceci constitue done I 'idee de base pour realiser une copie conforme et en profondeur d'un 
element. Maiscen'estpassuffisant, car I 'element peut avoir des attributs, qui dans la regie 
ci-dessus, sont ignores. Comme en XM L, un attri but n'est pas un enfant, les attributs ne 
sont done pas pris en compte par cette regie. 

Maisil suffitd'y penser, etdedemander I a recopie des attributs: 



La recopie d'un element, c'est : 

la copie de cet element 

a laquelle on accroche : 
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- la recopie des attributs s'il y en a, 

- la recopie des enfants s'il y en a. 

M ais du coup, si I'on fait ca, la regie est incomplete, car on y demande la recopie des 
attributs, alors qu'on definit la recopie d'element, mais pas celle d'attribut. La encore, 
c'est tres simple de corriger : 

la recopie d'un element ou d'un attribut. c'est : 



la copie de cet element ou de cet attribut 
a laquelle on accroche : 

- la recopie des attributs s'il y er 

- la recopie des enfants s'il y en c 



Si cette regie s'applique a un attribut, elle dit que la recopie d'un attribut, c'est la copie 
de cet attribut, suiviedela recopie deses attributs ou deses enfants. Mais un attribut n'a 
ni attribut ni enfant; la recopie d'un attribut se resume done a la copie de cet attribut, ce 
qui mafoi sembleassezsatisfaisant pour I 'esprit. 

TraduiteenXSLT, cette regie devient: 

<xsl :template match="child: :*| attribute: :*"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*"/> 
<xsl :apply-templates select="child: :*"/> 
</xsl :copy> 
</xsl :template> 

Notonsquechild: :* est la forme longuede "*", etque<xsl :apply-templates select= 

"child: :*"/> selectionne moins de types de nceuds que <xsi :appiy-tempiates/>. En 
effet, ce sont tous les enfants du nceud courant qui sont selectionnes par I 'instruction 
xsi :appiy-tempiates, pas seulement ceux qui sont des elements, maisaussi lestextes, 
les commentaires et les processing-instructions. 

Maislafacon dontla regie est ec rite, ci-dessus, renforce le parallele avec la definition en 
langue naturelle telle qu'on I'aetablie. 



II faut remarquer ici que I'ordre relatif des deux instructions xsi:appiy-tempiates est important, car il faut se 
rappeler ici qu'il est interdit d'accrocher un attribut a un nceud si on a deja commence a accrocher des enfants 
(voir Regie XSLT typique, page 291). 

Est-on arrive a la forme definitive de cette regie? Pas tout a fait. Pour I'instant nous 
traitons les elements et les attributs, mais il y a d'autres types de nceuds possibles : le 

type text, le type namespace, le type comment, le type processing-instruction, et 

le type root. 

Nousavons vu (voir Copie d'un n«ud de type element, page 326 et Copie d'un n«ud de 
type namespace, page 338) qu'un nceud de type namespace est copie automatiquement 
par I'instruction <xsi:copy> appliquee a un element, il n'est done pas necessaire de 
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s'occuper explicitement des domaines nominaux. De meme (voir Copie du no?ud de type 
root, page 339), la racine root de I'arbre XM L du resultat est creee automatiquement, 
sansqu'il y aitbesoin des'en occuper. Restentlestextes, les commentai reset les proces- 
sing-instructions. Leur point commun, c'est qu'ils sont chacun necessairement enfant 
d'un element. 

Si le nceud courant est un element, I'instruction <xsi :appiy-tempiates seiect= 
-child: :*■/> ne selectionne que des elements (voir Le determinant est une*, page 55). 

MaiS instruction <xsl :apply-templates sel ect="chi 1 d: :node( ) "/> (OU plUSSimple- 

ment <xsi:appiy-tempiates"/>), selectionne tous les nceuds qui peuvent etre des 
enfants du nceud courant : c'est exactement cela qu'il nous faut, puisque seront compris 
les commentaires, les textes, et les processing-instructions. Mais si on les selectionne, 
encore faut-il que la regie les accepte en entree ; il faut done aussi modifier en conse- 
quence I ' attri but match : 

<xsl : tempi ate match=" child: :node( ) | attribute: :*"> 

|<xsl :copy> 
<xsl :apply-templates select="attribute: :*"/> 
<xsl : apply- templates sel ect=" child: :node( )"/> 
</xsl :copy> 
</xsl :templ ate> 

Cette regie est maintenant correcte, mais on peut la simplifier legerement : 

|<xsl : tempi ate match=" child: :node( ) | attribute: :*"> 
<xsl :apply-templates select="child: :node( ) | attribute: :*"/> 
</xsl :copy> 
</xsl :template> 

Note 

On peuttoutefois s'interrogersurle bien-fondede cette simplification. En effet on a maintenant I'union dedeux 
node-sets, ce qui donne un nouveau node-set, dans lequel sont melanges des attributs, des elements, des 
textes, etc. Or un node-set n'est pas ordonne ; on peut done craindre que les noeuds ne soient pas traites dans 
le bon ordre (i.e. les attributs avantles elements). En fait, il n'y pas de probleme ici, carxsi :appiy-tempiates 
traite les noeuds du node-set renvoye par le sel ect dans I'ordre de lecture du document. Or I'ordre de lecture du 
document est parfaitement specifie, (voir Representation graphique, page 50), et stipule que pour un element 
donne, les attributs viennent avant les enfants. Done ici, nous retombons sur nos pieds, et nous sommes surs 
que les attributs (s'il y en a) seront traites avantles autres nceuds. 

La derniere petite touche que I'on peut apporter a cette regie, c'est de la rendre plus sure 
a utiliser dans des contextes differents : 

<xsl : tempi ate match=" child: :node( ) | attribute: :*" mode="copie"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*" mode="copie"/> 
<xsl :apply-templates select="child: :node()" mode="copie"/> 
</xsl :copy> 
</xsl :templ ate> 
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Cettefois, on a une regie qui n'estactiveequesi on precise I e mode « copie » ; ellepeut 
done coexister pacifiquement avec d'autres regies ayant un motif similaire, mais des 
transformations completement differentes. 

M ais il peut aussi arriver que I'on ait besoin que la copie soit conforme par defaut, sauf 
pour certains elements que I'on equipe d'une regie specifique. Dans ce cas, la copie ne 
doit pas etre lancee autoritairement sur tel element particulier, die doit se lancer toute 
seulequand il n'y a aucune autre regie eligible. 

Un exempledecetteideesetrouvemisen ceuvreaux sections Pattern n°8 - Utilisation 
d'une structure de donne'es auxilaire, page 422 et Pattern n°18 - Localisation d'une 
application, page 533. 



Celapeuttressimplementsefaireainsi : 



<xsl : tempi ate match="chi 


ld::i 


iode()|c 


ittribute::*" f 




<xsl :copy> 










<xsl :apply-templ, 


ates 


select= 


■"attribute::*' 




<xsl :apply-templ< 


ates 


select= 


: "child: :node( ) 




</xsl :Copy> 








</x 


si :template> 









En affectant une priori te extremement faible a cette regie, on est siir qu'elle ne sera selec- 
tionnee que si le processeur XSLT n'a vraiment rien d'autre a se mettre sous la dent. 

Terminons par une remarque concernant le degre de conformite d'une copie conforme : 
lepointdevueestici celui du parseurXML, non celui del'ceil humain. En particulier, il 
est impossible a priori de discerner deux documents XML qui ne different que de la 
facon dont sontecrits les attributs (avec desguillemetsou des apostrophes), ou lestextes 
contenant des caracteres interdits comme "<• ou "&" (avec des <![cdata[<]]> ou avec 
des&it: ). 

Copie presque conforme 

Nous partons ici d'un document XM L contenant du XHTM L genere par Docbook. 



Docbook est une DTD associee a des feuilles de style XS LT pour rediger des articles, des livres, et plus genera- 
lementde la documentation. Les feuilles de style XSLT produisentdu HTML ou du FO, lequel donne du PS ou 
du PDF avec des processeurs FO adequats (voir http://docbook.org). 



doc.xml 

|<?xml version="1.0" encoding="UTF-16"?> 
<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=UTF-16"/> 
<title>Generation de la documentation avec Docbook</title> 
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<link rel="stylesheet" href=" . .ess" type="text/css'7> 
<meta name="generator" content="DocBook XSL Stylesheets V0"/> 
</head> 

<body bgcolor="white" text="black" 1 1nk="#0000FF" vlink="#840084" al i nk="#0000FF' 
<div class="article"> <div class="titlepage"> 
<div> <hl class="title"> 

<a name="dOel"X/a>Generation de la documentation avec Docbook 
</hl> 
</div> 
</div> 

<p>Toutes ces modifications se trouvent dans le fichier principal 
<tt xmlns="http: //www. w3.org/TR/xhtmll/transitional" 

class="filename">C:\DocBook\RunDocBook\extensions\verbatim.java</tt>, 
qui a finalement 1 'allure suivante: 

<table xmlns="http: //www. w3.org/TR/xhtmll/transitional" 

border="l" bgcolor="#EOEOEO"> 
<caption al ign="right" cl ass="l istingTitle">verbatim. java</caption> 
<tr><td> 

<pre class="programl isting"> 
// ici listing de programme Java</pre> 
</td></tr> 
</table> 
</p> 
<!-- ... suite du fichier sans importance ... --> 
</div> 



Le vrai probleme que nous nous posons ici, e'est de modifier le listing qui se trouve 
entre les balises <pre> . . . </pre> en remplacant les tabulations initiales de chaque 
ligne de code par des series de quatre espaces. Ceci parce que les navigateurs 
comptent en general huit espaces par tabulation, ce qui est beaucoup trop pour 
certains listings. 

Traduit en terme de copie non conforme, cela veut dire que nous cherchons a faire une copie 
conforme du document, a ceci pres que les elements <pre> seront legerement differents dans 
leurcontenu. 

Cependant, ce probleme est curieusement difficile. 

Non pas a cause de la copie en elle-meme, qui repose sur ce qu'on vient de voir, ni a 
cause du remplacement de tabulations par des espaces, qui est simple a realiser. 

Ce probleme est difficile parce que I'element <pre> est un descendant de I'element 
<tabie>, qui declare un domaine nominal pardefaut. Cette difficulte est done complete- 
ment hors-sujet dans cette section, mais pour illustrer malgre tout cette notion de copie 
non conforme, nous allons supposer que nous voulons expurger la partie <nead> pour ne 
garder que la balise <ti ti e>, tout le reste etant conserve intact. 
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copie.xsl 

<?xml version='1.0' encodings ISO-8859-1' ?> 
<xsl: stylesheet xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 
version='1.0'> 

<xsl:output method='xml' indent="yes" encodings' ISO-8859-1' /> 

<xsl : tempi ate match="/"> 

<html> 

<xsl :apply-templates/> 

</html> 
</xsl :templ ate> 

<xsl :template match="/html/head"> 

<head> 

<xsl :apply-templates/> 

</head> 
</xsl :templ ate> 

<xsl :template match="/html/head/*"> 
</xsl :template> 

<xsl template match="/html/head/title" priority="2"> 

<xsl :apply-templates select="." mode="copie"/> 
</xsl :template> 

<xsl :template match="body"> 

<xsl :apply-templates select="." mode="copie"/> 
</xsl: template) 

<xsl :template match="child: :node() | attribute::*" mode="copie"> 
<xsl:copy> 

<xsl :apply-templates select="@*" mode="copie"/> 
<xsl :apply-templates select="node( )" mode="copie" /> 
</xsl :copy> 
</xsl :template> 

</xsl:stylesheet> 

La copie est lancee sur deux elements : <tnie> et <body> ; le reste est reconstruit a 
la main, eteventuellement modifie. Ici la non conformite dela copie est due a la regie 
<xsi template match="/htmi /nead/*"> ; cette regie annule tous les elements 
enfants de <nead>, sauf <titie>, qui beneficie d'une regie a part. On remarquera 
d'ailleurs la priorite 2 imposee a cette regie a part, pour eviter I'ambigui'te avec la 
regie d'annulation. 

Leresultatobtenu estbien celui qu'on attendait. 
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Pattern n° 11- Detection dun element avec domaine nominal 
par defaut 

Motivation 

La motivation est tres simple: on veut ecrire une transformation XSLT (peu importe 
laquelle) qui necessi ted 'ecrire une certaine regie pour un certain element. En principe, il 
n'y a rien de plus facile a fai re, il suffitd'ecrireparexemple: 

<xsl :template match="truc"> 
</xsl :templ ate> 

L e probleme qui peut survenir est que dans le document source X M L , I 'element <tmc> 
soit associe a un domaine nominal par defaut. 

La regie ci-dessus n'est alorsjamaisactivee, carle motif utilise, true, concorde avec tout 
element <truc> sans domaine nominal, mais pas avec un element possedant un domaine 
nominal, qu'il soitexpliciteou par defaut. 

Une solution decontournement peut eventuellementetre mi seen place, commececi : 

|<xsl:template match="*[ local -name( ) = 'true' ]"> 
</xsl:template> 

Cela fonctionne, car "*- ramasse tout ce qui se trouve sur I'axe child: :, et ensuite on 
filtre pour negarder que les elements dontlenom est egal alachaine 'true' . 

M ais ce n'est pas extraordinaire comme style, car cette regie sera selectionnee sur tout 
element, puis presque toujours rejetee a cause du predicat. Par ailleurs, on ne fait que 
contourner le probleme, alors qu'on pourrait le resoudre. 



La solution passe evidemment par I'ecriture d'un motif qui concorde avec un element 
<truc>, dans un certain domaine nominal par defaut. 

U ne chose est certaine, e'est que : 

<xsl :template match="truc"> 

concorde avec tout element <truc> qui n'est dans aucun domaine nominal. 

Si I'on veut ecrire un motif qui concorde avec un element <truc> dans un certain 
domai ne nomi nal , i I faut absol ument ecri re quel que chose du genre : 

<xsl :template match="xx:truc"> 

oil xx representeun prefixe(ou abreviation) d'un certain domaine nominal. 

Mais e'est precisement la que la difficulte surgit: si on ajoute un prefixe, le domaine 
nominal n'est plus « par defaut », penserez vous. Certes, mais ou? Parlons-nous d'un 
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domaine nominal « par defaut» dans le programme XSLT, ou « par defaut» dans le 
document source XM L ? 

Un domaine nominal, cela resteun domaine nominal, qu'il soit par defaut ou non. C'est 

done quel que Chose dU genre: http://www.machinchose.fr/bidule. 

Si le document source se presente comme ceci : 

<machin xmlns=" http://www.machinchose.fr/bidule"> 



</tn 
</machin) 



I' element <truc> a un domaine nominal par defaut. 
Si le document source se presente comme cela : 

<machin xmlns:xx=" http://www.mach inchose.fr/bidule' 



I</xx:truc> 
</machin> 

I'element <truc> a un domaine nominal explicite. 

Le point un peu subtil, mais ici essentiel pour obtenir la solution, c'est que dans les deux 
cas, le domaine nominal peut tr<?s bien etre le m^me, la seule difference re'sidant dans la 
fapon de ledire. 

Done une regie telle que: 

<xsl :template match="xx:truc"> 

n'est pas une regie concordant avec 

| tout element "true" dont le prefixe est "xx" 

mais avec 

tout element "true" dont le domaine nominal est 
| http://www.machinchose.fr/bidule 

ensupposantquexxsoitl'abreviation dece domaine nominal. 

La solution, pastresevidente, il fautbien lereconnaitre, est done de declarer un domaine 
nominal explicite dans le programme XSLT, comme ceci : 

<?xml version='1.0'?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

xmlns:xx="http: //www. machinchose.fr/bidule" 
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puis d'ecrire la regie en faisant mention du domaine nominal requis : 

<xsl :template match="xx:truc"> 
</xsl :templ ate> 

L e document source XML est suppose etre de la forme suivante : 

inchose.fr/bidule"> 



Le motif de la regie ci-dessus concorde avec tout nceud <tmc> dans le domaine nominal 
http://www.machinchose.fr/biduie ; or c'est precisement le cas de I'element <truc> du 
fragment XML ci-dessus. Done la regie s'appliquera bien a I'element <tmc> en ques- 
tion. 

Note 

Cette facon de resoudre le probleme est tellement peu intuitivement evidente, qu'elle a fait I'objet d'une requete 
officielle d'amelioration pour la version XSLT 2.0. On pourra consulter, dans http://www.w3.org/TR/xslt20req, la 
section intitulee « 2.1 Must Allow Matching on Default Namespace Without Explicit Prefix*. 

Exemple 

Nous allons pouvoir revenir au probleme de la copie non conforme dont il etait question 
a la section Copie presque conforme, page 447, etarriver cettefoisa une solution satis- 
faisante au probleme pose. Rappelons qu'il s'agit de modifier legerement le document 
XHTML produitparDocbook, en intervenantuniquementdanslesbalises<pre ciass= 
"programiisting n >, afin de supprimer les tabulations initiales de chaque ligne, en les 
remplacant par des series de quatre espaces. 

Voici toutd'abord un extraitdu document XHTML a transformer : 



<html> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=UTF-l 
<title>Generation de la documentation avec Docbook</title> 
< 1 ink rel="stylesheet" href="..css" type="text/css"/> 
<meta name="generator" content="DocBook XSL Stylesheets V0"/> 
</head> 

<body bgcolor="white" text="black" 1 ink="#00OOFF" vl ink="#840084" 
alink="#OOOOFF"> 
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<div class="article"> <div cl ass="titlepage"> 
<div> <hl class="title"> 

<a name="dOel"X/a>Generation de la documentation avec Docbook 
</hl> 
</div> 
</div> 

<div class="sectl"> <div class="titlepage"> 

<div> <h2 class="title" style="clear: both"> 

<a name="d0e38"X/a>l. Documentation avec docbook 
</h2> 
</div> 
</div> 

<div class="sect2"> <div cl ass="titlepage"> 
<div><h3 class="title"> 
<a name="d0e46"> 

</a>1.2. Description des principaux fichiers utiles 
</h3> 
</div> 
</div> 

<div class="sect3"> <div cl ass="titlepage"> 
<div> <h4 class="title"> 

<a name="d0e231"X/a>1.2.6. puratim.cl ass 
</h4> 
</div> 
</div> 
<p>Toutes ces modifications se trouvent dans le fichier principal 
<tt xmlns="http: //www. w3.org/TR/xhtmll/transitional" 
class="filename">C:.java</tt>, 

qui a finalement 1 'allure suivante: 

<table xmlns="http: //www. w3.org/TR/xhtmll/transitional" 

border="l" bgcolor="#EOEOEO"> 
<caption al ign="right" class="l istingTitle">puratim. java</caption> 
<tr> 
<td> 

<pre class="programlisting"> 
import java.io.*; 
public class puratim { 

public static void main( String arg[] ) { 
try { 

FilelnputStream fis = new FileInputStream( arg[0] ); 
InputStreamReader isr = new InputStreamReader( fis, "UTF-16" ); 
BufferedReader in = new BufferedReader( isr ); 

line = in.readLineO; // la 2' ligne n'est pas recopiee 
// (c'est la reference au graphe) 
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line = in.readLineO; 

if ( line == null ) break; 

pw.println( line ); 



} 
}</pre> 
</td> 
</tr> 
</table> 
</p> 

<p>A priori le service "Securite des reseaux" est au courant de ce probleme, 

qui devrait done etre resolu dans les jours qui viennent. 

Lorsque ce sera le cas, on pourra supprimer ce fichier 

<tt xmlns="http://www. w3.org/TR/xhtmll/transitional" 

class="filename">puratim.class</tt> 

</p> 

</div> 
</div> 



On voit que le probleme de la detection d'un element dans un domaine nominal par 
defaut va se poser ici, puisque I'element <pre . . .> fait partie de la descendance de 
<tabie ...>, qui declare le domaine nominal par defaut http://www.w3.org/TR/ 

xhtml 1/transitional. 

On va done mettre en ceuvre la solution indiquee plus haut; cela consiste d'abord a 
declarer un domaine nominal identique, identifie par une abreviation quelconque qui 
servira de prefixe. On ecrira done : 

<?xml version='1.0'?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

xmlns:dns="http: //www. w3.org/TR/xhtml 1/transitional" 

version='1.0'> 



Ensuite, puisque I'on veut tout copier a I'identique, sauf precisement les elements <pre 
ci ass="programi 1 sting ">, il va falloir ecrire une regie speciale pour ces elements : 

|<xsl :template match="dns:pre"> 
<pre cl ass="programl isting"> 
<xsl :cal 1 -template name="replace_first_tabs_on_al 1_1 ines"> 
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<xsl :with-param nan 


e="codeSource" 


</xs1 :call-template> 




1 :template> 





</x£ 

La regie ci-dessus semble correcte. Et pourtant ... Nous ne sommes pas au bout de nos 
peines avec les domaines nominaux. Telle qu'indiquee, la regie est correcte, du moins 
dans I'expression du motif : c'est tout I'objet de la discussion de la section precedente. 
Le corps de la regie, par contre, va poser a nouveau probleme; voici cequel'on vaobtenir 
lorsquelemodelede transformation decette regie sera instancie : 

<pre 

xmlns="" 

xmlns:dns="http: //www. w3.org/TR/xhtmll/transitional" 

class="programlisting"> 
import java.io.*; 
public class puratim { 

public static void main( String arg[] ) { 

}</pre> 

Dans le document resultatgenere, I'element <pre . . .> est defini avec un domaine nomi- 
nal par defaut nul (xmins="") ; cela signifie que cet element ne fait partie d'aucun 
domaine nominal par defaut. 

On a de plus une definition du domaine nominal http://www.w3.org/TR/xhtmii/tran- 
sitionai, deja declare dans I'element <tabie . . .>, mais comme domaine nominal par 
defaut, alors qu'ici, il est associe au prefixe dns. Pourquoi pas? Apres tout, ce qui 
compte, c'est que I'element soit associe au bon domaine nominal ; que ce soit par le 
truchementd'un domaine nominal par defaut ou explicite, peu importe. 

Oui, mais malheureusement, I'element < P re> n'a pas de prefixe. Et comme il ne fait 
desormais plus partie d'aucun domaine nominal par defaut, < P re> n'est done associe a 
aucun domaine nominal. En cela, la copie que nous avons realisee est trop infidele, car 
nous ne voulions pas modifier quoi que ce soit aux domaines nominaux, mais seulement 
fairesauter les tabulations. 

Cette fois, cependant, le probleme n'est pas difficile a identifier et a corriger ; c'est la 
regie que nous avons ecrite qui est i ncorrecte, car elle utilise I'element litteral sans le pre- 
fixe dns. Or, dans le programme XSLT, il n'y a pas de domaine nominal par defaut ; 
ainsi, un element litteral, comme <pre>, qui apparait sans prefixe, est un element sans 
domaine nominal. Le processeur XSLT a done genere une declaration d'annulation de 
domaine nominal (sous la forme xmins=" n ) afin d'obeiranosordres. 
Le plus dur est peut-etre de real i ser qu'on a effectivement donne cet ordre. 
Ayant vu cela, la correction est immediate : 

<xsl :template match="dns:pre"> 

<dns:pre cl ass="programl isting"> 

<xsl :cal 1 -tempi ate name="replace_fi rst_tabs_on_all_l ines"> 
<xsl :with-param name="codeSource" select="." /> 
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I </xsl: call -template) 

</dns:pre> 
</xsl: template) 

Avec cette regie corri gee, on obtiendra ceci : 

<dns:pre 

xmlns:dns="http: //www. w3.org/TR/xhtmll/transitional" 

class="programlisting"> 
import java.io.*; 
public class puratim { 

public static void main( String arg[] ) { 

}</dns:pre> 

Cette fois, c'est bon, le document resultat est identique au document d'origine du point 
de vue du traitement des domaines nominaux. La seule difference, c'est que dans le 
document d'origine, I'element <pre> est associe a un domaine nominal par defaut, alors 
que dans le document resultat, il est associe a un domaine nominal explicite. Mais 
comme dans les deux cas, il s'agit du meme domaine nominal, les deux documents sont 
equival ents du poi nt de vue X M L . 

Le programme XSLT estcelui-ci (les modelesnommesrealisant la suppression effective 
des tabulations ne sont pas montres, car ils sont hors-sujet pour ce qui nous occupe 
actuellement) : 

tabsToSpaces.xsl 

<?xml version='1.0'?> 

<xsl: stylesheet xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 

xmlns:dns="http: //www. w3.org/TR/xhtmll/transitional" 

version='1.0"> 



<xsl:output method='html' encodings' ISO-8859-1' /> 
<xsl :template name="replace_f i rst_tabs_on_al 1_1 ines"; 
</xsl :template> 



<xsl :template match="/"> 

<xsl :apply-templates mode="copie"/> 
</xsl :template> 

<xsl :template match="dns:pre" mode="copie"> 

<xsl :comment>Dans pre[@class='programl i sting] '</xsl : comment) 

<dns:pre class="programl isting"> 

<xsl :cal 1 -template name="replace_first_tabs_on_al 1_1 ines"> 

<xsl :with-param name="codeSource" select="." /> 
</xsl : call -template) 
</dns:pre> 
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</x 



I :template> 



<xsl :template match="child: :node( ) | attribute::*" mode="copie 
<xsl:copy> 

<xsl :apply-templates select="@*" mode="copie"/> 
<xsl :apply-templates select="node( )" mode="copie" /> 
</xsl :copy> 
</xsl :templ ate> 



</xsl: stylesheet) 

Etvoici maintenantleresultatobtenu (la presentation aete remaniee pour lesbesoinsde 
lamiseen page) : 

docSansTabs.html 

<html> 

<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 
<meta http-equiv="Content-Type" content="text/html ; charset=UTF-16"> 
<title>Génération de la documentation avec Docbook</title> 
< 1 ink rel="stylesheet" href="..css" type="text/css"> 
<meta name="generator" content="DocBook XSL Stylesheets V0"> 

</head> 



<body bgcolor="white" text="bla( 
alink="#0000FF"> 
<div class="article"> 
<div class="titlepage"> 
<div> 

<hl class="title"> 
<a name="dOel"X/a> 
Génér= 
</hl> 



="#0000FF" 



i de la documentatiot 



="#840084" 



iss="sect2"> 
class="titlepage"> 
iiv> 

<h3 class="title"> 

<a name="d0e46"X/a> 

1.2. Description des principaux fichier 
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</h3> 
</div> 



<di v class="sect3"> 

<div class="titlepage"> 
<div> 

<h4 class="title"> 

<a name="d0e231"X/a>1.2.6. puratim. class 
</h4> 
</div> 
</div> 
<p>Toutes ces modifications se trouvent dans le fichier principal 
<tt xmlns="http: //www. w3.org/TR/xhtmll/transitional" 
class="filename">C:.java</tt>, 
qui a finalement 1 'allure suivante: 

<table xmlns="http: //www. w3.org/TR/xhtmll/transitional" 
border="l" bgcolor="#EOEOEO"> 
<caption al ign=" right" class="l istingTitle">puratim. java</caption> 
<tr> 
<td> 
<!--Dans pre[@cl ass=' program! i sti ng] ' --> 
<dns:pre 

xmlns:dns="http: //www. w3.org/TR/xhtmll/transitional" 
class="programlisting"> 
import java.io.*; 
public class puratim ( 
public static void main( String arg[] ) { 
try { 

FilelnputStream fis = new FilelnputStreamt arg[0] ); 
InputStreamReader isr = new InputStreamReadert fis, "UTF-16" ); 
BufferedReader in = new BufferedReader( isr ); 

line = in. readLinet ) ; // la 2° ligne n'est pas recopiée 

// (c'est la référence au graphe) 
for(;;){ 

line = in.readLineO; 

if ( line == null ) break; 

pw.printlnt line ); 



</dns:pre> 
</td> 
</tr> 
</table> 
</p> 
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<p>A priori le service "Sécurité des réS6 
est au courant de ce problème, qui devrait done ê 
résolu dans les jours qui viennent. Lorsque ce sera le 
on pourra supprimer ce fichier 
<tt xmlns="http: //www. w3.org/TR/xhtmll/transitional" 

class="filename">puratim.class</tt> 
</p> 

</div> 
</div> 



</body> 
</html> 



Si I'on compare maintenant le document original et celui obtenu, on constate des diffe- 
rences de presentation, et d'encodage des caracteres non A scii, mais aucune difference de 
structure X M L . On a les meme elements, avec les memes attributs et les memes domai- 
nes nominaux. La suppression des tabulations n'est pas visible ici, mais ce n'est pas vrai- 
ment le sujet qui nous a donne du travail. On pourra toutefois trouver une discussion 
specifique sur cesujet a la section Exemple, page 402. 

Finalement, on voit que ce n'est pas forcement si evident que ca de realiser une copie 
presque conforme d'un document utilisant les domaines nominaux. M ais les solutions a 
mettre en ceuvre, pour ces problemes de domaines nominaux, sont assez generiques ; 
el les sont done parfaitement reutilisables dans d'autres circonstances, sans rapport avec 
des copies presque conformes. 

Pattern n° 12- References croisees inter fichiers 

Motivation 

L es problemes de references croisees sont tres frequents en X SLT ; ce sont des problemes 
oil, pour traiter une information A, il faut en deduire une information B, puis rechercher 
cette information B, eventuellement dans un autre document, qui donne acces a une 
information C. On peut alors presenter cote a cote les informations A etc. 

S'il y a beaucoup d'informationsA a traiter, le point critique est la recherche de B dans 
tout un document, car cette recherche est multiplied par le nombre de A a traiter. 

Une solution efficaceconsistealorsa indexer les informations A par les informations B, 

en Utilisant le COUple instruction xsl :key/fonction key(). 

N ous allons montrer eel a sur un exemple mettant en ceuvre deux fichiers source XML. 

Pour cela nous reprenons I 'exemple que nous avions vu a la section Exemple, 
page 307. N ous avions un fichier codesPi ages .xmi contenant des informations sur des 
codes utilises par ailleurs : 
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codes PI ages .xml 



Dn="1.0" encodings ISO-i 



pt" r 



<artistes> 

<artiste id="cpl 

<artiste id= 

<artiste id="eblq' 

<artiste 1d="fmrf 

<artiste id="oded' 

<artiste id="fech' 

<artiste id="dsmp' 

</artistes> 



ie="Christine Plubeau'7> 
ie="NoSlle Spieth'7> 
ie="Eric Bellocq"/> 
ie="Frederic Martin"/> 
ie="0dile Edouard"/> 
ie="Freddy Eichelberger"/ 
ie="David Simpson"/> 



istruments> 

<instrument id="vdg" name="Viole de gambe"/> 

<instrument id="clv" name="Cl avecin"/> 

instrument id="thb" name="Theorbe"/> 



instrument 
instrument 
instrument 
instrument 



-11" 



d="v 



ne="Violon baroque"/> 
ne="Violon baroque"/> 
ne="0rgue positif"/> 
ne="Violoncelle baroque"/> 



Par ai lleurs, nousavionsunfichierXM L contenantdes descriptions de plages de CD, mis 
en place dans ce memeexemple, et modi fie par la suite pour illustrer le principe de nume- 
rotation des nceuds (voir Exemple, page 350). 



PlagesCD.xml 

<?xml versio 
<plages> 



"1.0" encoding="IS0-8859-l"?; 



<plage No="l" vdg="cplu" 
thb="eblq" 
vl2="oded" 



/ll="fmrt" 



Grave </plage> 



<plage No="2" thb="eblq" 

clv="nspt" vll="fmrt" 
vl2="oded" vlc="dsmp"> Presto 

<plage No="3" vdg="cplu" clv="nspt" 
thb="eblq" vll="fmrt" 
v!2="oded"> Adagio </plage> 



thb="eblq" vdg="cplu" 
clv="nspt" vll="fmrt" 
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vlc="dsmp" 

org="fech"> Presto Recit de bas: 



</plages> 



Ce fichier indique, pour chaque plage, la distribution sous forme d'attributs dont les 
noms sont des codes d'instruments, et les valeurs sont des codes d'artistes. Tous ces 
codes ont leur traduction en clair dans le fichier codesPiages.xmi. II s'agit maintenant 
d'ecrire une transformation XSLT qui permette d'obtenir le fichier suivant (qui, mis en 
forme, pourrait figurer dans la pochette du disque, puisqu'il donne pour chaque artiste, 
les numerosde plages ou il intervient, et I 'instrument dont il joue) : 

Resultat attendu 



Chris 


itine 


Plube 




1 3 4 


■ Viol 


e de 


gatnbe 


Noel 1 
1 2 ; 


e Spi 
i 4 CI 


eth 


n 



Frederic Martin 

12 3 4 Violon baroque 



Odile Edouard 

12 3 Violon baroque 



Freddy Eichelberger 
1 4 Orgue positif 



David Simpson 
| 2 4 Violoncelle baroque 

Puisque I'on veut un fichier ou les informations soient classees artiste par artiste, il semble 
logique deconsiderer que le fichier codesPiages.xmi sera le fichier principal, et I'autre le 
fichier secondai re. Lecheminementpeutalorssefairecommececi : 

1) Partantd'un <artiste>,onason id (parexemplecplu)etson nom (Christine Plubeau). 

2) Connaissant I'id cplu on va rechercher dans le fichier piagesCD.xmi toutes les 
<piage>qui ont un attri but dont la valeur est cplu, cequi permetd'afficherlesnumeros 
de plages. 

2) Puis ayant I'une de ces plages, il faut noter le nom de I'attribut dont la valeur 
correspond a la valeur cherchee (cplu dans I'exemple), ce qui nous donne le code 
de ^instrument joue (vdg, en I'occurrence). 

2) Enfin, ayant ce code, on revient dans I e document source principal, oul'on recherche un 
instrument dont le code correspond, etil n'y a plus qu'a afficher le nom de cet i nstrument. 
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Realisation 



L a premiere chose a faire est de mettre en place une table d'association qui va donner des 
<pi age>, connaissant des id d' artistes. 

Or, dans le fichier piagesCD.xmi, les id d'artistes ne sont pas references par des attributs 
dont le nom est fixe ; il suffit qu'on ajoute un nouvel instrument, pour que cela donne un 
nouveau nom d'attribut, dontlavaleurestun idd'artiste. La cle sera done declaree ainsi : 

<xsl :key name="PlagesParCodesArtistes" 

match="plage" use="attribute: :*" /> 

Comme I'attribut use est une expression renvoyant un node-set, chaque valeur textuelle 
de chaque nceud de ce node-set va jouer le role de valeur de cle ; une fois construite, la 
table va done avoir I'allure representee a la figure 9-1. 




Figure 9-1 

Plages par codes artistes. 
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Dememe, il va nous falloir une cle pour avoir un <instrument> connaissantson 1 



Note 

On pourrait ici utiliser la fonction id( ), qui renvoie I'element dont I'identifiant est egal a une valeur donnee. 
Neanmoins, on ne le fait pas, car la manipulation d'identifiant est plus lourde : il faut declarer I'attribut correspon- 
dent du type predefini ID, ce qui de fait, oblige a equiper le fichierXML d'une DTD. Une cle apporte ici beaucoup 
plus de souplesse, en nous affranchissantcompletementde I'obligation d'une DTD. 

Ceci etant, on peutcommencer a coder la transformation. L e but etantde I isterdes artistes, 
on vadonc parti r du flchier codes pi ages, xmi, ettraiter les elements <artiste> : 



<xsl : tempi ate match="arti 


ste 


<xsl : tempi ate match="arti 


ste 


<xsl : call -tempi ate na 




<xsl:with-param n 


ame 


</xsl:call -template) 




<xsl :cal 1 -tempi ate na 




<xsl :with-param n 


ame 


</xsl:call-template> 





<xsl :call -tempi ate name="instancier-NomInstrumentDeCetArtiste"> 

<xsl:with-param name="codeArtiste" select="@id"/> 
</xsl: call -tempi ate> 

</xsl :templ ate> 

</xsl :templ ate> 

II s'agit maintenantde determiner les trois modeles nommes. 

Instanciation du nom de I'artiste 

II n'y a pas de difficulty particul iere ici : 

<xsl :template name="instancier-NomArtiste"> 
<xsl :param name="nomArtiste"/> 



<xsl : val ue-of select="$nomArtiste"/> 
<xsl:call-template name="instancier-sautLigne'7> 
</xsl :template> 

Instanciation des Nos de plages 

II faut maintenant construire la table associee a la cle piagesParCodesArtistes, 
construction qui doitsefaireen explorantlefichierXM L auxiliaire PiagesCD.xmi. C'est 
la fonction keyo qui realise cette tache, et on sait que I'arbre explore est celui qui 
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contient lenoeud contexte del'evaluati on del 'expression contenant I'appel. Pour explo- 
rer I'arbreXM L du document contenu dans PlagesCD.xml, il faut done placer le noeud 
contexte de cet appel quelque part dans cetarbre. La racine n'etant pas un plus mauvais 
endroitqu'un autre, on peutdonc obtenir I'effet desire en ecrivant : 



<xsl : tempi ate 
<xsl :paran 



:for-each sel ect=" document (' PI agesCD.xml ')' 



ici le ncud contexte est la racine de l'arbre XML du document 
contenu dans PlagesCD.xml , car la fonction documentO renvoie 
un node-set ne contenant que la racine du document demande. 



</xsl :for-each> 
</xsl :template> 
En mettant I'appel a key ( "PlagesParCodesArtistes", $codeArtiste ) a la place du 

commentaireci-dessus, on va done construireune table d'apres lebon fichier XM L. 

M ais cet appel est susceptible de renvoyer plusieurs nceuds, puisque un meme artiste peut 
intervenir pour plusieurs plages du CD. II faut done explorer un par un les nceuds ren- 
voyes, avec un xsi :for-each , dans lequel le noeud contexte est a nouveau change, et 
passe tour a tour sur chaque <pi age> renvoyee : 

<xsl :template name="instancier-NosPlagesAvecCetArtiste"> 
<xsl:param name="codeArtiste"/> 

<xsl :for-each sel ect=" document (' PlagesCD.xml ' )"> 

<xsl :for-each select='key( "PlagesParCodesArtistes", 
$codeArtiste )'> 
<xsl:value-of select=" ./attribute: :No"/> 
<xsl:text> </xsl:text> 
</xsl:for-each> 
</xsl :for-each> 

</xsl :template> 

Instanciation des noms d'instruments 

Si I'on connaitle code instrument, un appel a 

key( "InstrumentsParCodesInstruments" , Scodelnstrument ) 

renvoie l'<instrument> cherche. Ici, l'arbre XML a explorer est celui du document 
source principal, done en principe, lenoeud contexte, quel qu'il soit, est dans cet arbre : 
inutile ici d'immerger I'appel a keyo dans un xsi:for-each pour placer le noeud 
contexte dans le bon arbre X M L . Ayant l'<instrument> cherche, il n'y a plus qu'a prendre 
lavaleurdeson attributnom : 
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si :template name="instancier-NomInstrumentDeCetArtiste"> 
<xsl :param name="codeArtiste"/> 
<xsl :variable name="codeInstrument"> 

<xsl :cal 1 -template name="instancier-codeInstrument"> 

<xsl :with-param name="idArtiste" select="ScodeArtis 
</xsl :cal 1 -template> 
</xsl:variable> 

<xsl 



<xsl :cal 1 -tempi ate name="instancier-sautLigne"/> 
</xsl : tempi ate> 

L e probleme est done d'obtenir le code instrument connaissant le code artiste. U n appel a 

key( "PlagesParCodesArtistes", SidArtiste ) 

renvoie les plages ou I'artiste intervient, a condition bien sflr que cet appel soit place dans 

un xsi :for-each pour que le noeud contexteindiquelebon arbreXM L, comme a la sec- 
tion precedente (voir Instanciation des Nos de plages, page 463). Ayant I 'ensemble des 
plages pour un artiste donne, on considere I'uned'elle, peu importe laquelle. La premiere 
est le choix le plus simple, car si cet ensemble n'est pas vide, on est sfir que la premiere 
existe: 

<xsl variable name="unePlageAvecCetArtiste" 

select='key( "PlagesParCodesArtistes", 
SidArtiste )[1]' /> 

Ayant une plage, par exemple : 

<pl age No="3" vdg="cplu" clv="nspt" 
thb="eblq" vll="fmrt" 

vl2="oded"> Adagio </plage> 

et connaissant I e code artiste, par exemple "epiu", il fauten deduirelenom del'attribut 
dontla valeurest "epiu" (ici vdg). Dans I ' ensem bl e des attri buts de la plage courante, il 
fautdonc recuperer celui dontla valeurest cell edu code artiste donne : 

$unePlageAvecCetArtiste/attribute::*[ . = SidArtiste ] 

Ayant I 'attri but (qui est un noeud detype attribute), il n'y a plus qu'a appeler la fonc- 
tion predefinie l ocai -name qui va renvoyer son nom, correspondant au code instrument ; 
ce qui nous donne le modele nomme d'instanciation de ce code instrument 

<xsl :template name="instancier-codeInstrument"> 
<xsl:param name="idArtiste"/> 
<xsl :for-each select="document( 'PI agesCD.xml ' )"> 
<xsl :variable name="unePlageAvecCetArtiste" 

select='key( "PlagesParCodesArtistes", 
SidArtiste )[!]' /> 
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SunePlageAvecCetArtiste/attribute: :* 
[ . = SidArtiste ] )" /> 

</xsl:for-each> 

</xsl :template> 

Programme complet 

En reunissant tous les morceaux, on obtient finalement le programme suivant : 

distribution.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='text' encodings' ISO-8859-1' /> 

<xsl :key name="PlagesParCodesArtistes" 

match="pl age" use="attribute: :*" /> 



:lect="document( 'plagesCD.xml ' )" /> 



<xsl : tempi ate name="instancier-NomArtiste"> 
<xsl :param name="nomArtiste"/> 

<xsl :text> </xsl :text> 

<xsl :call -template name="instancier-saiJtLigne"/> 

<xsl :value-of select="$nomArtiste"/> 
<xsl :cal 1 -template name="instancier-sautl_igne"/> 
</xsl :template> 



xsl :template na 


ne="i 


istancie 


r-NosPlagesAvecCetArtiste"> 


<xsl :param n 




;odeArtiste"/> 




<xsl:for-eac 


i sel 


2ct="$ra 


cinePlages"> 




<xsl:for 


each 


select= 


'key( "PlagesP 
ScodeArt 


rCodesArtistes" , 
ste )'> 


<xsl 


valu 


3-of sel 


ect="@No"/> 




<xsl 


text 


> </xsl 


text> 




</xsl:fo 


--eac 


n> 
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</xsl:for-each> 
</xsl :template> 



<xsl :template name="instancier-NomInstrumentDeCetArtiste"> 
<xsl :param name="codeArtiste"/> 
<xsl :variable name="codeInstrument"> 

<xsl :cal 1 -template name="instancier-codeInstrument"> 

<xsl :with-param name="idArtiste" select="$codeArtiste"/> 
</xsl: call -template) 
</xsl:variable> 

<xsl 



<xsl :cal 1 -tempi ate n 
</xsl :templ ate> 



<i-- ========================================== -> 

<xsl :template name="instancier-codeInstrument"> 
<xsl :param name="idArtiste"/> 
<xsl :for-each select="$racinePlages"> 

<xsl :variable name="unePlageAvecCetArtiste" 

select='key( "PI agesParCodesArtistes" , 
SidArtiste )[1]' /> 

<xsl :value-of select="local -name( 

SunePlageAvecCetArtiste/attribute:: 
[ . = SidArtiste ] )" /> 



</xsl:for-each> 
</xsl :template> 



<xsl :template name="instancier-sautLigne"> 
<xsl:text> 
;sl:text> 
</xsl :templ ate> 



<xsl :template match="artiste"> 

<xsl :call-template name="instancier-NomArtiste"> 

<xsl :with-param name="nomArtiste" select="@nom"/> 
</xsl :call-template> 



Patterns de transformation 



template name 


="instancier-NosPl agesAvecCetArtiste"> 


ith-param nair 


e="codeArtiste" select="@id"/> 


-tempi ate> 




template name 


="instancier-NomInstrumentDeCetArtiste 


ith-param nair 


e="codeArtiste" select="@id"/> 


-tempi ate> 





<xsl :template match="text( )"/> 



</xsl:stylesheet> 



Pattern n° 13 - Generation d'hyper liens 

Motivation 

Dans la section precedente (voir Pattern n°12 - References croisees interveners, 
page 459), il s'agissaitdesuivredes references en passant de fichier en fichier ; ici lepro- 
bleme est degenererdes hyper-liens. Typiquement, en HTM L, ces hyper liens serontdes 
paires <a name=" ..."> <a href=" ...">. Si HTM L est cite ici en exemple, c'est unique- 
ment parce que les balises <a> sont bien connues ; mais le probleme est exactement le 
meme pour n'importe quel texte ou I'on doitemettre des references a d'autres parties du 
document, et se resout de la meme facon. 

On serestreintici aun seul document, mais si I'on voulaitemettre des references de type 
<a href=". . . "> vers un autre document, il suffiraitdecombinerlesideesmisesenceuvre 
dans cette section, avec celles de la section precedente (Pattern n°12 - References 
croisees inter ^chiers, page 459). 

L'idee de base, ici, est d'utiliser la fonction generate-id() pour obtenir une chaine de 
caracteres qui pourra servir d'identifiant pour une ancre referencable. 

U ne autre idee est que nous sommes ici dans un domai ne ou la notion de cle d'indexation 
a des chances d'etre utile. 

Prenons par exemple ce fichier XML: 



<?xml version="1.0" encoding="UTF-16"?> 
<Saison> 

<Periode> Automne 1999 </Periode> 
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<Manifestations> 
<Concert> 

<Organisation> Anacreon </Organisation> 

<Date>Samedi 9 octobre 1999 <Heure> 20H30 </Heure> </Date> 

<Lieu>Chapelle des Ursules</Lieu> 
</Concert> 
<Theatre> 

<Organisation> Masques et Lyres </Organisation> 

<Date>Mardi 19 novembre 1999 <Heure> 21H </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 
<Theatre> 

<Organisation> Masques et Lyres </Organisation> 

<Date>Mercredi 20 novembre 1999 <Heure> 21H30 </Heure> </Date> 

<Lieu>Salle des Cordel iers</Lieu> 
</Theatre> 
</Manifestations> 



<Adrc 



a des Ursules</Lieu> 
sules - 49000 Angers 



le des Cordeliers 
; Prevoyants de 1 



On veut obtenir une version HTLM dece document, avec un lien actif de chaque lieu 
vers son adresse. Done, arrive sur un <Lieu> de concert ou de theatre, il faut referencer 
le <Lieu> correspondant, enfant de <Adresse>. Pour cela, il faut chercher, parmi les 
enfants d'elements <Adresse>, un <Lieu> dont la valeur textuelle soit la meme que 
celledel'element <Lieu> courant. A ce<Lieu> ainsi trouve, on associera un identifiant 
par la fonction generate-id( ), et cet identifiant servira ensuite de reference pour les 
balises <a>. 

Si les references a emettre sont peu nombreuses, et le document a traiter peu vol umi neux, 
cela peut rester acceptable de rechercher le <Lieu> parmi les <Adresse> a chaque fois 
qu'on a besoin d'emettreun <a href=". . .">. Maisdanslecascontraire, il estbeaucoup 
plus efficacedeconstruire une cle d'indexation des <Lieu>. 



Realisation avec recherche par cle 

La cle est ici a construire en recoltant des <Lieu> enfants d'elements <Adr( 
prenant la valeur textuelle du <Lieu> comme valeur de cle : 



1 : key n 



natch="Adresse//Lie 
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Les ancres a generer sont soit de la forme <a href=". . .">, soit de la forme <a name= 
". . .">. Dans les deux cas, I 'attribut sera egal a#at>c, ou abcestunechainedecaracteres 
caracteristique, fournie par la fonction generate-id( ). 

Done, connaissant la valeur litteraled'un lieu, par exemple chapeiie des ursuies, on 
recherche le< n eu> correspondant par la fonction keyo. Le resultat est necessai rement 
un node-set a un et un seul element : on transmet done cet element a generate-i d( ), et la 
valeur renvoyee va constituer la fin de la reference (le debut etant le caractere ■#'). Par 
exemple, 

<a name="#{generate-id(key('lieux', 'Chapeiie des Ursuies ') )}"> 

generelabaliseHTML : 

<a name="#d0e56"> 

La valeur d0e56 n'est pas predictible, bien sflr; ici, e'est un exemple obtenuavec Saxon. 

Remarquez la facon dont le descripteur de valeur differee d'attribut est employe: 
"#{. . . }. A pres le guillemet, la valeur del 'attribut commence par un •#'. Ensuitevientle 
descripteur, introduit par le caractere ■ { ■. Le descripteur est evalue, et sa valeur vient 
s'aj outer au '#' deja pris en compte. On auraiteventuellement pu tout calculer dans le 
descripteur: 

<a name="{concat('#' , generate-id(key( '1 ieux' , 'Chapeiie des Ursuies ')) )}"> 

Un programme possible detraitementdecefichierXM L est done lesuivant : 

Saison.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

version="1.0"> 

<xsl:output method='htmT encodings' ISO-8859-1' /> 
<xsl:key name="l ieux" match="Adresse//Lieu" use="." /> 



si :template match="/"> 
<html> 
<head> 

<title>Programme Saison 
<xsl:value-of 

select="/Sai son/Peri ode" /> 
</title> 
</head> 
<body bgcolor="white" text="black"> 

<xsl :apply-templates/> 
</body> 
</html> 
<sl :template> 
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<xsl : tempi ate match="Saison"> 

<xsl :apply-templates select="Manifestations"/> 

<H3>Adresses :</H3> 

<xsl :apply-templates select="Adresse"/> 
</xsl :templ ate> 

<xsl :template match="Concert |Theatre"> 

<H3Xxsl:value-of select="local -name( . )"/> </H3> 
<p>Date : <xsl:value-of select="Date"/> <br/> 

Lieu : <a href="#{generate-id(key( '1 ieux' , ./Lieu))}"> 
<xsl:value-of select="Lieu'7> 

</p> 
</xsl :template> 

<xsl : tempi ate match="Adresse"> 

<p><a name="#{generate-id(key('lieux', ./Lieu)))"> 
<xsl:value-of select="Lieu"/> 
</a> 
<br/> 

<xsl:value-of select=" ./child: :text( )[2]'7> 
</p> 
</xsl :templ ate> 

<xsl :template match="text( )"/> 
</xsl:stylesheet> 

On notera lafacon d'obtenir letexteassocieauneadresse: 

<xsl :value-of select^" ./child: :text( )[2]"/> 

Le texte utile est le deuxieme, car le premier n'est compose que d'espaces blancs : ce sont 
lesespacesblancssituesentrelafin dela balise<Adresse> et ledebut de la balise<i_ieu>. 

Une alternative serait d'utiliser I'instruction <xsi :strip-space> qui supprime tous les 
noeuds text ne contenant que des espaces blancs. Cette solution est meilleure dans la 
mesure ou elleevited'avoir a gerer I 'invisible. Nous la mettrons en ceuvre dans la variante 
de la prochaine section, a titre de comparaison. 

Le resultat obtenu avec Saxon est donne ci-dessous (les valeurs d'ancres dependent du 
processeur utilise) ; voir aussi la figure 9-2. 

Saison.html 

<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<title>Programme Saison Automne 1999 </title> 
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</head> 

<body bgcolor="white" text="black"> 
<H3>Concert</H3> 
<p>Date : Samedi 9 octobre 1999 20H30 <br> 

Lieu : <a href="#d0e56">Chapel le des Ursules</aX/p> 
<H3>Théâtre</H3> 
<p>Date : Mardi 19 novembre 1999 21H <br> 

Lieu : <a href="#d0e62">Sal le des Cordel iers</a></p> 
<H3>Théâtre</H3> 
<p>Date : Mercredi 20 novembre 1999 21H30 <br> 

Lieu : <a href="#d0e62">Sal le des Cordel iers</a></p> 
<H3>Adresses :</H3> 

<p><a name="#d0e56">Chapelle des Ursules</aXbr> 
9, rue des Ursules - 49000 Angers 



</p> 



="#d0e62">Salle des Cordel iers</a><br> 

1, rue des Prévoyants de 1'avenir - 49000 Angers 



Figure 9-2 

Rendu HTML du 
fichier Saison.html 
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Lieu : Chap elle des Ursules 
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Date : Mardi 19 Novembre 1999 21H 
Lieu: Salle des Cordeliers 
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Adresses : 




Chapelle des Ursules 

9, rue des Ursules - 49000 Angers 




Salle des Cordeliers 

1, rue des Prevoyants de ravenii - 49000 Angsts 
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Realisation avec recherche par expression XPath 

II n'y a pas de difficult^ particulierea utiliser une expression XPath pour rechercher un 
lieu de meme valeur textuelle que le lieu courant ; le seul petit probleme est I 'ecriture du 
predicat oil I 'on a besoin a la fois du nceud contexte et du nceud courant. N ous avons deja 
rencontre ce probleme et vu comment le resoudre : reportez-vous a la fin de la section 
Exemple, page 187. 

Le programme est donne ci-dessous ; le resultat est exactement identique au precedent, 
instruction <xsi :strip-space eiements= n *" /> permet de supprimer de I'arbre X M L 
les noeuds text ne contenant des espaces blancs; en consequence, instruction 
<xsi :vaiue-of sei ect=" ./child: =text( )"/> est maintenant beaucoup plus naturelle 
que dans la version precedente. 

Saison.xsl 



<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 



<xsl:output method='htnl' encodings ISO-8859-1' /> 
<xsl :strip-space elements^"*" /> 

<xsl : tempi ate match="/"> 
<html> 
<head> 
<title> 

Programme Saison 

<xsl:value-of select="/Saison/Periode"/> 
</title> 
</head> 
<body bgcolor="white" text="bl ack"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :template> 

<xsl :template match="Saison"> 

<xsl :apply-templates select="Manifestations"/> 

<H3>Adresses :</H3> 

<xsl :apply-templates select="Adresse"/> 
</xsl: template) 

<xsl :template match="Concert |Theatre"> 

<H3Xxsl:value-of select="local -name( . )"/> </H3> 
<p>Date : <xsl :value-of select="Date"/> <br/> 

Lieu : <a href="#{generate-id(/Saison/Adresse/Lieu 
[ . = currentO/Lieu ] 
)}"> 
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<xsl :template match="text( )"/> 



</xsl:stylesheet> 

Pattern n° 14- Regroupements 

Motivation 

L e regroupement est un probleme tres frequent dans les transformations X SLT. 1 1 se pose 
a chaquefois que le document X M L a traiter contient des informations disseminees ici et 
la, mais ayant toutes un point commun (par exemple, des villes, qui font toutes partie 
d'un pays; des instrumentistes, qui jouenttousd'un certain instrument; des pieces (de 
maisons), qui ont toutes une certaine surface, etc.). II y a plusieurs sortes de regrou- 
pements, qui dependent decequ'on veutobtenir, etdu point devueadopte pour decider 
du point commun a considerer. 

Dans un regroupement par valeur, le probleme consiste a produire un document resultat 
dans lequel par exemple les villes sont regroupees par pays, les instrumentistes par 
instrument, les pieces par surface, etc. 

Dans un regroupement positionnel, le but est de rassembler des elements dont les posi- 
tions (ausein d'une certaine I iste) sont identiques d'un certain point devue. Par exemple, 
on a une listede villes, eton veutlesregroupertroispartrois. 

Enfin, une derniere categorie de regroupement est la restauration hierarchique de docu- 
ments XML. II s'agit ici de reconstituer la structure hierarchique d'un document XML 
qui a ete « aplati » pour une raison quelconque. Un exemple de document plat a deja 
ete rencontre (voir lefichier company. xmi, a la section Exemple plus <?volu<?, page 275) ; 
la restauration hierarchique d'un tel document consisterait a reconstituer un vrai docu- 
mentXML : 



Fichier aplati 



;ion="1.0" encoding="UTF-16" : 
ne="COMPANY"> 
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N0ACA<tab/>CHAR(6Xbr/> 

LSACAKtab/>VARCHAR2(35Xbr/> 

CCPAAKtab/>NUMBER(4Xbr/> 

LAACAKtab/>VARCHAR2(35Xbr/> 

URL<tab/>VARCHAR2(40Xbr/> 

STATRAT<tab/>VARCHAR2( 1 )<br/> 

</table> 

Fichier restaure 

<?xml version="1.0" encoding="UTF-16" 
<table name="COMPANY"> 

<field> 

<name>NOACA</name> 
<type>CHAR(6X/type> 

</field> 

<field> 

<name>LSACAK/name> 
<type>VARCHAR2(35X/type> 

</field> 



Remarque 

La future version 2.0 de XSLT devraitinclure des possibilities pour specifier des regroupements, parce que tout 
le monde s'accorde a reconnaitre que les regroupements ne sont pas simples a programmer, alors qu'ils font 
partie du quotidien. 

Regroupements par valeur ou par position 

D'une facon generate, on peut dire qu'on a identifie un probleme de regroupement par 
valeur quand les deux conditions suivantes sont reunies : 

1) L'arbreXML contient certains nceuds N d'un certain type pour lesquels on dispose 
(au moinsconceptuellement) d'une certainefonction valeur, telle que vaieur(N) ren- 
voie un resultat qu'on peut appeler la valeur de N . Suivant ce point de vue, la valeur 
d'un ville, c'est son pays ; la valeur d'un instrumentiste, c'est son instrument ; et la 
valeur d'une piece, c'est sa surface. 

2) Le document resultat doit contenir les nceuds N regroupes par valeursidentiques. 

Un regroupement par position est en fait un cas particulier du precedent, oil la valeur 
d'un element est liee a sa position au sein d'une certaine liste. La position etant donnee 
par un nombre entier, la valeur d'un element, dans ce cas, est done numerique. Par exem- 
ple, si Ton a une liste de villes a regrouper trois par trois, on prendra pour valeur d'une 
ville le tiers de sa position dans cette liste, de telle sorte que chaque groupe de trois soit 
constitue de vil les de meme valeur. 
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Dans son principe, la solution consiste a proceder en deuxetapes: 

• Etape 1: on commence par constituer I'ensemble NVD des nceuds de type T de 
valeurs toutes differentes. 

• Etape 2 : on parcourt(2a) I'ensemble NVD, et pour chaque nceud (ayantunecertaine 
valeur v) de cet ensemble, on selectionne (2b) I'ensemble des nceuds de type T de 
I'arbreXM L qui ontv pour valeur : ces nceuds sont regroupes par valeur. 

L'etape 1 est done une etape de constitution d'un ensemble de valeurs toutes differentes ; 
or nous avons deja vu comment resoudre ce probleme (voir Node-set de valeurs toutes 
differentes, page 438). La methode de Steve M uench est parti culierement recommandee 
ici, car elleest baseesur la construction d'unecle, qui va aussi servir dans l'etape 2, en 
rendant sa mise en ceuvre parti culierement simple. 

Des pieces regroupees par surface habitable (regroupement par valeur 
d' attribute) 

Nous allons continuer le meme exemple qu'a la section Node-set de valeurs toutes diffe- 
rentes, page 438, afin de pouvoir reprendre la realisation obtenue par la methode de la 
de. 

Lefichier XM L a traiter est le suivant : 



maisons.xml 


[ <?xml version="1.0" encoding="UTF-16" standalone="yes"?> 


I <maisons> 


<maison id="l"> 


<RDC> 


<cuisine surface='40m2'> 


Evier inox. Mobil ier encastre. 


</cuisine> 


<WC> 


Lavabo. Cumulus 200L. 


</WC> 


<sejour surface='40m2'> 


Cheminee en pierre. Poutres au plafond. 


Carrelage terre cuite. Grande baie vitree. 


</sejour> 


<bureau surface='15m2'> 


Bibliotheque encastree. 


</bureau> 


<garage/> 


</RDC> 


<etage> 


<terrasse>Palmier en zinc figurant le desert. </t 


<chambre surface='28m2' fenetre='3'> 


Carrelage terre cuite poncee. 


<alcove surface='8m2' fenetre='l'> 


Lambris. 


</alcove> 
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</chambre> 
<chambre surface='l 

Lambris. 
</chambre> 
<salleDeBains surfa 

Douche, baignoi 



<RDC> 

<cuisine surfa 
en ruine. 

<garage/> 
</RDC> 
<etage> 

<terrasse> 



Douche. 


</salleDeBains> 


</etage> 


</maison> 


<maison id="3"> 


<RDC> 


<sejour surface='40m2'> 


paillasson a 1 'entree 


</sejour> 


</RDC> 


<etage> 


<chambre surface='28m2'> 


porte cochere. 


</chambre> 


</etage> 


</maison> 


</maisons> 


Lefichier quel'on souhaiteobtenirestcelui-ci : 


pieces.xml 


<?xml version="1.0" encoding-"IS0-8859-l"?> 


<piecesParSurfaces> 


<pieces surface="40m2"> 


<cuisine idMaison="l">Evier inox. Mobilier encastre.</cuisi 


<sejour idMaison="l">Cheminee en pierre. Poutres au plafond 


Carrelage terre cuite. Grande baie vit 


<sejour idMaison="3">pail lasson a 1 'entree</sejour> 
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<pieces surface="15m2"> 

<bureau idMaison="l">Bibl iotheque encastree.</bureau> 

<chambre idMaison="l">Lambris.</chambre> 

<sa11eDeBains idMaison="l">Douche, baignoire, 1 avabo.</salleDeBains> 

<salleDeBains idMaison="2">Douche.</sal leDeBains> 
</pieces> 

<pieces surface="28m2"> 

<chambre idMaison="l">Carrelage terre cuite poncee.</chambre> 

<cuisine idMaison="2">en ruine.</cuisine> 

<chambre idMaison="3">porte cochere.</chambre> 
</pieces> 

<pieces surface="8m2"> 

<alcove idMaison="l">Lambris.</alcove> 
</pieces> 

</piecesParSurfaces> 

La realisation del'etapeladejaetefaite, nousavionsobtenu lade : 

|<xsl :key name="groupesdeSurfacesParValeurs" 
match="attribute: :surface" 

et nous avions obtenu I'expression qui donne I 'ensemble des valeurs toutes differentes : 
Creation d'un node-set de surfaces toutes differentes 

//attribute: :surface[ 
generate-id() = 
generate-id( 

key( 'groupesdeSurfacesParValeurs' , . )[1] 

] 

La realisation del'etape2 est tres simple: il suffit de parcourir I 'ensemble obtenu, cequi 
va nous donner des valeurs toutes differentes, et ensuite, pour chaque valeur, d'exploiter 
la de pour obtenir les nceuds possedant cette valeur. 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" vers 

<xsl:output method^'xml' encoding=' ISO-8859-1' indent="yes" /> 
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lsemble de valeurs toutes differentes 



variable name="lesDifferentesSurfaces" 
select="//attribute: :surface[ 
generate-id( ) = 
generate-id( 

key( 'groupesdeSurfacesParValeurs ' , . )[1] 



]" /> 



Etape 2A : parcours des valeurs de cet ensemble 

<xsl :for-each select="$lesDifferentesSurfaces" > <!-- 

ici le nffiud courant est un naud attribute: :surface 

<xsl :variable name="valeurCourante" select="." /> 
<pieces surface="{$valeurCourante}"> 

Etape 2B : parcours des nsuds ayant cette valei 

<xsl:for- 

ici le nceud courant est un nceud attribute:: 



<xsl :element name="{local -name($pieceCourante)}"> 
<xsl attribute name="idMaison"> 
<xsl:value-of select=" 
SpieceCourante/ancestor: :maison/@id"/> 
</xsl: attribute) 
<xsl:value-of select=" 

normal ize- space ($pieceCourante/chi Id: :text( ) )' 
</xsl:element> 
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</xsl:for-each> 
</piecesParSurfaces> 
<sl :template> 



</xsl:stylesheet> 

Le resultat obtenu est exactement celui montre ci-dessus (a part quelques sauts de lignes 
ajoutespour la lisibilite). 

Les villes regroupees par pays (regroupement par valeur d'attributs) 

On suppose qu'on a un fichier XM L donnant unelistede villes avec, pour chacune, son 
pays: 

villes.xml 



<?xml versio 


n="1.0" encoding="UTF-16" standa 


<Villes> 




<V1lle n 


om="Paris" pays="France" /> 


<Ville n 


om="Madrid" pays="Espagne" /> 


<Ville n 


om="Milan" pays="Ital ie" /> 


<Ville n 


om="Rome" pays="Ital ie" /> 


<Ville n 


om="Angers" pays="France" /> 


<Ville n 


om="Barcelone" pays="Espagne" /> 


<Ville n 


om="Venise" pays="Ital ie" /> 


<Ville n 


om="Cordoue" pays="Espagne" /> 


<Ville n 


om="Naples" pays="Ital ie" /> 


</Villes> 





On veut la liste des villes par pays. La methode est exactement la meme, bien que le 
fichier X M L a traiter soit d'un structure assez differente : 



version="1.0" encoding="UTF-16"?> 
stylesheet xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" version="1.0"> 



<xsl:output method='text' encodings' ISO-8859-1' /> 



<xsl :key name="groupesDePaysParNoms" 
match="attribute: :pays" 



; toutes differentes 



ime="lesDifferentsPays" 
?lect="//attribute: :pays[ 
generate-id( ) = 
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generate-id( 

key( 'groupesDePaysParNoms' , . )[1] 



<xsl : tempi ate match="/"> 

Etape 2A : parcours des valeurs de cet ensemble 
<xsl :for-each select="$lesDifferentsPays"> <!-- 

ici le niEud courant est un nceud attribute: :pays 

- <xsl:value-of select="."/> : 

<xsl :variable name="tousLesAttributsPaysDeMemeValeur" 

select="key( 'groupesDePaysParNoms' , .)" /> 

Etape 2B : parcours des ncuds ayant cette valeur 

<xsl :for-each select="$tousLesAttributsPaysDeMemeValeur"> 

ici le nfflud courant est un ncud attribute: :pays 



le name="laVilleCorrespondante" 
select^". /parent: :node()" /> 
2- of select="$l aVil leCorrespondante/@nom"/> 



</xsl :templ ate> 
</xsl: stylesheet) 
Resultat 

- France : 

. Paris 
. Angers 

- Espagne : 

. Madrid 
. Barcelon 
. Cordoue 
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. Rome 
. Venise 
. Naples 



Les instrumentistes regroupes par instruments (regroupement par valeur 
de noeuds texte) 

Dans les deux exemples precedents, les valeurs servant de valeur de cle etaient des 
valeurs d'attributs. Cen'estnullementune obligation : cetexempleva lemontrer. 
On part d'un fichier XML comme ceci : 

Concert.xml 

I <?xml version="1.0" encoding="UTF-16" standalone="yes"?> 



<Entete> Les Concerts d'Anacreon </Entete> 
<Date>Mardi 11 Fevrier 2003, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> Hesperion XXI </Ensemble> 

<Interprete> 

<Nom> Jordi Savall </Nom> 
<Instrument>Dessus de viole</ Instruments 
</Interprete> 

<Interprete> 

<Nom> Wi el and Kuijken </Nom> 

<Instrument>Hautecontre de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sophie Watillon </Nom> 

<Instrument>Hautecontre de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Sergi Casademunt </Nom> 
<Instrument>Tenor de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abra 

<Instrument>Basse 
</Interprete> 
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<Interprete> 

<Nom> Marianne Muller </Nom> 

<Instrument>Basse de viole</Instrument> 
</Interprete> 

<Interprete> 

<Nom> Philippe Pierlot </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<TitreConcert> 

Fantasias for the Viols (1680) 
</TitreConcert> 

<Compositeur>Henry Purcell</Compositeur> 



Eton veutobtenir la distribution du concert, classeepar instruments. Ici, les « valeurs » 
d'instruments sont leurs noms, qui ne sont pas des attributs, mais des nceuds texte. 

distribution.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='text' encoding=' ISO-8859-1' /> 



Etape 1 : constitution d'un ensemble de valeurs toutes differentes 



<xsl :variable name="lesDifferentsInstruments" 
select="//Instrument[ 

generate-id( ) = 
generate-id( 

key( 'groupes I nterpretes Par Instruments' , . )[1] 
) 
]" /> 



<xsl :template match='7"; 
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Etape 2A : parcours des valeurs de cet ensemble 

<xsl :for-each select="$lesDifferentsInstruments" > <!-- 

ici le nffiud courant est un ncud <Instrument> 

<xsl :variable name="valeurCourante" select^"." /> 
- <xsl :value-of select="$valeurCourante"/> 

<!-- 

Etape 2B : parcours des <Instrument> ayant cette valeur 

<xsl :for-each select="key( 'groupesInterpretesParlnstruments' , 
SvaleurCourante)" > <!-- 

ici le nffiud courant est un nteud <Instrument> 



<xsl :variable name="instrumentiste" 

select="./parent: :Interprete" /> 
. <xsl :value-of select="$instrumentiste/Nom"/> 
</xsl:for-each> 
</xsl:for-each> 
</xsl :template> 



</xsl:stylesheet> 
Resultat 



- Dessus de viole 

. Jordi Savall 

- Hautecontre de viole 

. Wieland Kuijken 
. Sophie Watillon 

- Tenor de viole 

. Sergi Casademunt 

- Basse de viole 

. Sylvia Abramowicz 
. Marianne Muller 
. Philippe Pierlot 
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Chapitre 9 

Les villes trois partrois (regroupement positionnel) 

Leprobleme est tres simple : on a unelistede villes, eton veut les afficher sous la forme 
d'un tableau de trois colonnes par ligne. Nousreprenonsdonc lememefichierquecelui 
qui aservi pour regrouper les villes par pays: 

villes.xml 

<?xml version="1.0" encoding="UTF-16" standalone="yes"?> 
<Villes> 

<Ville nom="Paris" pays="France" /> 

<Ville nom="Madrid" pays="Espagne" /> 

<Ville nom="Milan" pays="Ital ie" /> 

<Ville nom="Rome" pays="Ital ie" /> 

<Ville nom=" Angers" pays="France" /> 

<Ville nom="Barcelone" pays="Espagne" /> 

<Ville nom="Venise" pays="Ital ie" /> 

<Ville nom="Cordoue" pays="Espagne" /> 

<Ville nom="Naples" pays="Ital ie" /> 
</Villes> 

Le fichier a obtenir est Ie suivant : 



<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8 

<title> Les villes </title> 
</head> 

<body text="black" bgcolor="white"> 
<table> 
<tr> 

<td>Paris</td> 
<td>Madrid</td> 
<td>Milan</td> 
</tr> 
<tr> 

<td>Rome</td> 
<td>Angers</td> 
<td>Barcelone</td> 
</tr> 
<tr> 

<td>Venise</td> 
<td>Cordoue</td> 
<td>Naples</td> 
</tr> 
</table> 
</body> 
</html> 
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Leprincipen'estpas different, malgre le fait que le regroupement soit ici positionnel : il 
suffit de se ramener a un poi nt de vue dans I equel la valeur d'une ville est mai ntenant non 
plus son pays, maissa position au sein de la fratrie des villes. 

La premiere etape sera done comme d'habitude de constituer une de de regroupement 
par valeur. 

<xsl:key name="lesVil lesParPosition" 



Neanmoins, le probleme est ici dedefinir la position de la ville courante, lors de deva- 
luation de I 'expression X Path fournie par I'attribut use. 

Remarque importante 

II faut ici se souvenir que cette expression XPath est evaluee avec le nceud en concordance comme nceud 
contexte, et une liste reduite au seul nceud contexte comme liste contexte. Si bien que la fonction predefine 
positiono ne peutque renvoyerla valeur 1, si on I'appelle quelque partau sein de cette expression. II faut 
done definitivement abandonner I'idee d'utiliser cette fonction dans une expression pour le calcul de la valeur 
d'une cle, si on I'avait jamais eue : une fonction qui renvoie toujours 1 n'estpas vraimentdes plus utiles. 

Ici, la liste interessante n'est done pas la liste contexte formee lors de revaluation de 
I'expression attribut de use, mais le node-set des <viiie>, enumere dans I'ordrede lec- 
ture du document, qui donne la numeration (en partant arbitral rement de 0) (Paris), 

I (Madrid) 8 (Naples). 

Pour une <viiie> donnee, son numero est done egal au nombre d'elements contenus 
dans le node-set des <vnie> qui sont des preceding-sibling de la <viiie> courante. Si 
done I'onevalue I'expression 

preceding-sibling: :Ville 

par rapport a un nceud contexte qui est une <vi n e> V quelconque, on obtient le node-set 
detoutes les villes situees avantV dans I'ordrede lecture du document. 
L'expression qui donne la position d'une telle <viiie>V est done : 

count( preceding-sibling: :Ville ) 

si toutefois devaluation a bien lieu par rapport au nceud contexte V. 

II est done possible, maintenant, de determiner I'expression qui va fournir la valeur de 
regroupement des villes : 

|<xsl :key name="lesVillesParPosition" 
match="Ville" 
use="floor( count(preceding-sibl ing: :Vil le) div 3 )" /> 

L'operateur div est la division ; les calculs se faisant en nombres reels double precision, 
il est necessaire de prendre la partie entiere du quotient obtenu, d'ou I'appel a la fonction 
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Avec cette definition de de : 

• lesvi lies Paris, Madrid, et Milan ontpourvaleurO; 

• lesvi lies Rome, Angers, et Barcel one ont pour valeur 1 ; 

• les villes Venise, Cordoue, et Naples ont pour valeur 2. 

L'etape 1 consiste comme d'habitude a constituer I 'ensemble des elements de valeurs 
toutes differentes (ici des villes), mais c'est plus simple a realiser que dans les exemples 
precedents, car les villes qui vont constituer cet ensemble ont un numero que I'on peut 
calculer a I'avance : ce sont les villes numerotees (Paris), 3 (Rome), et 6 (Venise), qui 
ont respectivement pour valeur 0, 1, et 2. initialisation de la variable contenant le node- 
set des villes de valeurs toutes differentes va done pouvoir s'ecrire : 

<xsl : variable name="lesDifferentsGroupesDeVil les" 
select="//Ville[ 

((positionO - 1) mod 3) = 
]" /> 

Ici, la fonction positionO peut etre utilisee, car elle est appelee dans un predicat qui 
filtre un node-set constitue de toutes les villes : lors de devaluation du predicat, la liste 
contexte est constitute des elements du node-set a filtrer, done la fonction positionO 
renvoie la position de la ville courante au sein de cette liste, ce qui donne le resultat 
attend u. 

On peut done maintenantecrire I e programme, dont le plan reprendtresexactementcelui 
des autres exemples de regroupements que nous avons deja vus. 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"; 

<xsl:output method='html' encoding=' ISO-8859-1' /> 

<xsl :variable name="facteurDeRegroupement" select="3"/> 

<xsl :key name="lesVillesParPosition" 
match="Ville" 
use="floor( counttpreceding-sibling: :Ville) div 3 )" /> 

<!-- 

Etape 1 : constitution d'un ensemble de valeurs toutes differentes 

<xsl variable name="lesDifferentsGroupesDeVil les" 
select="//Vi11e[ 

((positionO - 1) mod SfacteurDeRegroupement) = ( 
]" /> 
<!-- 
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3l:tenplate match="Vil les"> 
<table> 

Etape 2A : parcours des valeurs de cet ensemble 
<xs1:for-each select="$lesDifferentsGroupesDeVilles"> 



ici le noeud courant est un noeud Ville 
(la premiere de chaque ligne du tableau) 
Sa valeur de cle est donnee par positionO - 1 



<xsl variable name="valCle" select="position( ) - 1" /> 
<tr> 

Etape 2B : parcours des noeuds ayant cette valeur 
<xsl:for-each select="key( 'lesVil lesParPosition' , SvalCl 

<! — 

ici le noeud courant est une ville 

<td><xsl :value-of select="@nom"/X/td> 
</xsl:for-each> 



<xsl :template match="/"> 
<html> 

<head> 

<title> Les villes </title> 

</head> 

<body text="black" bgcolor="white"> 

<xsl :apply-templates/> 

</body> 
</html> 
</xsl :template> 

</xsl: stylesheet) 

L e resultat obtenu est celui montre plus haut (fichier vi 1 1 es . html ) ; on observera le desa- 
grement que procure I 'interdiction d'utiliser une reference de variable dans I 'attri but use 
del 'instruction xsi :key. 



Pattern n 14- Regroupements 



Regroupements hierarchiques 

Les regroupements hierarchiques consistent a reconstituer explicitement une hierarchie 
d'elements, absente du document a traiter, mais neanmoins sous-jacente. Au lieu d'etre 
veritablement arborescent, avec des elements i mbriques, I e document est en effet genera- 
lementreduit a une structure lineaire d'elements juxtaposes. C'estcequi expliquequ'un 
regroupement hierarchique ne soit pas sans rapport avec un regroupement positionnel, 
dans la mesure ou la reconstitution du niveau hierarchique d'un element est en partie 
basee sur sa position dans la structure lineaire. 

L a valeur d'un element sera done ici la pi ace hierarchique que I 'element devra avoir dans 
le document resultat, ce qui est equivalent a dire que la valeur d'un element, e'est le 
noeud qu'il devrait avoir pour parent dans le document source. 
D'une facon general e, on peut affirmer qu'on a identifie un probleme de regroupement 
hierarchique quand les deux conditions suivantes sont reunies : 

1) L'arbreXML contientcertainsnceudsN d'un certain type pour lesquels on dispose (au 
moins conceptuellement) d'une certaine fonction valeur, telle que vaieur(N) renvoie 
I'identite du noeud qui devrait etre le parent de N, si la hierarchie etait correctement 
respectee. 

2) Le document resultat doit contenir les nceuds N, reorganises (ou regroupes) de 
telle sorte que chaque noeud N ait pour parent un noeud dont I'identite estegalea 

valeur(N). 

Dans son principe, la solution consiste a proceder en deux etapes : 

• Etape 1 : on commence par une reconstitution des relations hierarchiques. Chaque 
noeud n a traiter est associe par une cle a sa valeur hierarchique (I'identite du noeud qui 
devrait etre le parent deN). A la fin decette operation, il est done possible d'obtenir le 
node-set des enfants directs de chaque noeud p du document : en effet, connaissant p, 
on connaitson identite I (generate- ido),et la cle donnealors tousles elements ayant 
i pour valeur, e'est-a-diretous les elements ayant p pour parent. 

• Etape 2 : on parcourt la hierarchie, en partantdu sommet. Connaissant lesommet, on 
en deduit les enfants qu'il devrait avoir, gracealacleobtenueal'etapeprecedente, et 
on les construit dans le document resultat. II n'y a plus qu'a reprendre ce processus, 
non pi us avec lesommet, mais avec chacun des enfants, etainsi de suite recursivement 
avec tout le reste de la hierarchie. 

Exemple generique 

Cet exemple est un exemple simple et generique, qui revient assez souvent sous di verses 
formes sur la mailing-list X SLT (www.biglist.com/lists/xsl-list/archives). 



Note 



n retrouvera cet exemple avec le moteurde recherche disponible a I'adresse ci-dessus : chercher « De-flatte- 
ing an XML tree ». 
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Chapitre 9 

On partd'un fichier plat, commececi : 

flatDatas.xml 

<?xml version="1.0" encoding="UTF-16" ?> 
<recordset> 
<record/> 
<data/> 
<data/> 
<record/> 

<data/> 
<record/> 
<data/> 
<data/> 
<data/> 
</recordset> 

et on veut reconstituer un fichier hierarchique, comme cela : 



<?xml version="1.0" encoding="ISO-E 
<recordset> 
<record> 
<data/> 
<data/> 
</record> 



<record> 

<data/> 

<data/> 

<data/> 

</record> 

</recordset> 

Premiere etape 

Dans la premiere etape, il s'agit de reconstituer la hierarchie sous-jacente. L'idee est 
done de rattacher chaque element a son parent : les <record> doivent etre rattaches au 
<recordset>, et chaque <data> au premier <record> qui apparait dans le sens inverse de 
celui de la lecture du document. Pour cela, on va affecter a chaque element une valeur 
egalea I'identite deson parent potenti el, etmaintenir cette information grace a unecle, 
dont on peut voir la structure a la figure 9-3. 

La figure 9-3 montre la structure plate du fichier XM L, et comment retrouver les enf ants 
directs d'un noeud : par exemple le <record> A correspond a la valeur VA, qui est la 
valeur du noeud <data> B, ce qui signifie que le <record> A a pour enfant I'element 
<data> B. Dememe, le noeud <recordset> correspond a la valeur VRS, qui est la valeur 
des trois noeuds <record>, ce qui signifie que le <recordset> a pour enfants les trois 
<record>. B i en sur, cette derni ere valeur decle est redondanteavec la structure memede 
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I'arbreXM L de depart, qui donnedejacette information, mais il est plus simple degar- 
der cette redondance pour regulariser la structure du programme, qui pourra ainsi tou- 
jours passer par la cle pour obtenir les enfants directs d'un nceud. 




Figure 9-3 

Cle pour retrouver les enfants directs d'un na?ud. 

Les elements <data> ne correspondent a aucune valeur, parce qu'ils n'ont pas d'enfants 

directs. 

En resume, si I 'on considere I 'ensemble des valeurs, et que I 'on y choisit une valeur V 

quelconque, on peut dire que : 

• V correspond a un (et un seul) nceud N ; 

• V est la valeur d'un ensemble de nceuds E . 

On saitalors que le nceud N devrait avoir les nceuds E pour enfants. C'estpourquoi la cle 

estnommee "lesEnfantsDirects". 

U ne fois qu'on a vu la structure de la cle a obtenir, il n'y a plus qu'a trouver comment I'ini- 
tialiser. Partant d'un element E quelconque dans ledocumentoriginal, il s'agitde determiner 
son parent potenti el, etd'associeraE une valeur qui est 1'identifiant de ce parent potentiel. 
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Mais il y a deux types d'elements dont il faut trouver les parents : les <data> et les 
<record>. Pour un noeud <data>, il faut rechercher le premier <record> en remontant 
vers la racine du document, et la valeur associee est dans ce cas I'identifiant de ce 
<record>. M ais pour un noeud <record>, il faut prendre le parent <recorset>, et I'identi- 
fiant de ce <recordset> est alors la valeur du noeud <record>. 

On est done dans un cas ou la de doit etre constitute en deux fois: une premiere 
declaration pour le parent des nceuds <record>, et une deuxieme pour les parents des 
noeuds<data>, commececi : 

Premiere etape : initialisation de la cle des enfants directs 

<xsl :key 

name="lesEnfantsDi rects" 

match="record" 

use="generate-id( parent: : recordset )" /> 

<xsl :key 

name="lesEnfantsDi rects" 

match="data" 

use="generate-id( preceding-sibl ing: : record[l] )" /> 

Cette facon de constituer une meme cle en deux fois est parfaitement autorisee, et le 
resultat est conforme a ce que montre la figure 9-3. 

Deuxieme etape 

La deuxieme etape est une etape de parcours recursif de la hierarchie memorisee dans la 
cle. U n tel parcours a une structure extremement regul iere que I 'on retrouvera a I 'identique 
dans tous les problemes de regroupements hierarchiques. 

On commence par le sommet de la hierarchie : 

Deuxieme etape : parcours hierarchique (debut) 

:xsl :template match="recordset" > 
<recordset> 

<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , generate-id( .))"/> 
</recordset> 
7xsl :template> 

lei, I'on construit I 'element <recordset> en lui affectant pour enfants ceux que va nous 
donner lacle pour la valeur correspondent a I'identifiant du noeud courant, e'est-a-direle 

<recordset>. 

Les enfants du <recordset> etant des <record>, il suffit maintenant d'ecrire une regie 

pour les <record> : 

Deuxieme etape : parcours hierarchique (suite) 

<xsl :template match="record" > 
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<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , gene rate -id( .))"/> 
</record> 
</xsl :templ ate> 

Les enfants d'un element <record> etant des <data>, qui sont des elements terminaux de 
la hierarchie, on vacettefois ecri re pour I es elements <data> une regie non recursive, qui 
se contentera de recopier cet element dans le document resultat. 

On peutdonc maintenantdonner le programme complet: 

unflatten.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='xml ' encoding=' ISO-8859-1 ' indent='yes' /> 
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<xsl :key name="lesEnfantsDi rects" 
match="record" 
use="generate-id( parent: : recordset )" /> 

<xsl :key 

name=" lesEnfantsDi rects" 

match="data" 

use="generate-id( preceding-sibl ing: : record[l] )" /> 



-sif de la hierarchie 



<xsl : tempi ate match="/"> 

<xsl :apply-templates /> 
</xsl :template> 

<xsl :template match="recordset" > 
<recordset> 

<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , generate-id( . ' 
</recordset> 
</xsl :template> 
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<xsl :template match="record" > 
<record> 

<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , generate- id( .))"/> 
</record> 
</xsl :template> 



i de la hierarchie 



! :template match="data" ) 
<xsl :copy-of select^"."/ 
;1 :template> 



</xsl:stylesheet> 

Reconstitution hierarchique d'un texte 

Le programme que I'on vient devoir s'appliquait a un exempletres simple, comportant 
une hierarchie presque triviale. Nous allons maintenant voir que si I'on s'attaque a la 
reconstruction d'une hierarchie beaucoup plus complexe, cela ne change rien a la struc- 
ture du programme, que I'on va done pouvoir reprendre integralement du programme 
precedent. Parcontre, cequi peutdevenirun peucomplique, c'estd'exprimerles concor- 
dances de motifs adequates pour les initialisations des valeurs de la cle. 

Le probleme est maintenant de transformer un document XM L representant un texte 
(typiquement un livre ou un article), structure en chapitres, sections, etc., pour passer 
d'une representation plate a une representation hierarchique. Ce genre de probleme 
peuteventuellementse poser quand on veut adapter un texteexistanta une nouvelle 
DTD. 

Ce probleme revientassez souvent et sous diverses formes sur la mailing-list XSLT : faire 
une recherche de « transforming an incorrectly structured document » sur www.google.fr , 
parexemple. 

Nous parti ronsde I 'exemplesuivant, assez representatif du probleme: 



texte. xml 










<?xml v 


rsion="1.0 


encoding 


="UTF 


16" ?> 


<docume 


t> 








<titreSectionl 


titre A 


C/tit 


eSectionl> 




<p> para 1 


</p> 








<titreSect 


on2> titr 


2 A.l 


</titreSecti 




<p> pa 


a 2 </p> 
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<p> para 3 </p> 
<p> para 4 </p> 
<titreSection2> titre A. 2 </titreSection2> 
<p> para 5 </p> 

<titreSection3> titre A. 2.1 </titreSection3> 
<p> para 6 </p> 
<p> para 7 </p> 
<titreSection2> titre A. 3 </titreSection2> 
<p> para 8 </p> 
<titreSectionl> titre B </titreSectionl> 

<titreSection2> titre B.l </titreSection2> 

<titreSection3> titre B.l.l </titreSection3> 

<p> para 9 </p> 
<titreSection3> titre B.l. 2 </titreSection3> 
<p> para 10 </p> 
<titreSection2> titre B.2 </titreSection2> 
<p> para 11 </p> 
</document> 

L 'indentation permet de mieux apprehender la structure du texte, mais il faut bien voir 
qu'il n'y a ici aucune imbrication d'elements. 

On veutecri re une transformation qui aboutisseaceci : 



texteReconstruit.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<Document> 
<Sectionl> 

<titre> titre A </titre> 
<p> para 1 </p> 
<Section2> 

<titre> titre A.l </titre> 
<p> para 2 </p> 
<p> para 3 </p> 
<p> para 4 </p> 
</Section2> 
<Section2> 

<titre> titre A. 2 </t1tre> 
<p> para 5 </p> 
<Section3> 

<titre> titre A. 2.1 </titre> 
<p> para 6 </p> 
<p> para 7 </p> 
</Section3> 
</Section2> 
<Section2> 

<titre> titre A. 3 </titre> 
<p> para 8 </p> 
</Section2> 
</Sectionl> 
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<Sectionl> 

<titre> titre B </t1tre> 
<Section2> 

<titre> titre B.l </titre> 
<Section3> 

<titre> titre B.l .1 </titre> 
<p> para 9 </p> 
</Section3> 
<Section3> 

<titre> titre B.l. 2 </titre> 
<p> para 10 </p> 
</Section3> 
</Section2> 
<Section2> 

<titre> titre B.2 </titre> 
<p> para 11 </p> 
</Section2> 
</Sectionl> 
</Document> 



Le programme general de reconstruction d'une hierarchie etant applicable ici, nous 
pouvons done tout de suite I 'ecri re, en laissanten blanc I 'initialisation delacle : 

Ebauche de la transformation 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" version="1.0"> 

<xsl:output method='xml ' encoding=' ISO-8859-1' indent='yes' /> 



Reconstitution des relations hierarchiques 



<xsl :key name="lesEnfantsDirects" 
match="??" 
use="??" /> 

<xsl:key . . . /> 



<xsl : tempi ate match="/"; 
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<xsl :apply-templates /> 
</xsl :templ ate> 

<xsl : tempi ate match="document" > 
<Document> 

<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , gene rate -id( .))"/> 
</Document> 
</xsl :templ ate> 

<xsl : tempi ate match="titreSectionl" > 
<Sectionl> 

<titreXxsl:value-of select=" . "/></titre> 
<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , gene rate -id( .))"/> 
</Sectionl> 
</xsl :templ ate> 

<xsl :template match="titreSection2" > 
<Section2> 

<titre><xsl:value-of select=". "/></titre> 
<xsl :apply-templates 

select="key( 'lesEnfantsDi rects', generate-id( . ) )"/> 
</Section2> 
</xsl :template> 

<xsl :template match="titreSection3" > 
<Section3> 

<titre><xsl:value-of select=" . "/></titre> 
<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , generate-id( .))"/> 
</Section3> 
</xsl :templ ate> 



<xsl :template match="p" > 

<P> 

<xsl:value-of select-" 

</p> 
</xsl :template> 



On voit combien le programme est semblable au precedent, du moins pour ce qui est de 
I'etape 2, ou I'on doit faire un parcours recursif de la hierarchie. 



(Patterns de transformation 
Chapitre 9 

Pour etablir I *i nitial isation correctede la de, il fauttoutd'abord determiner la structure 
hierarchique possible, c'est-a-dire en fait la DTD du document resultat. II n'est pas 
necessai rede formal iser celasous la forme d'unevraie DTD, il suffitici de dire que: 

• un <Document> peut avoir pour enfantsdes<sectioni> ; 

• une<sectioni> peutavoirpourenfantsdes<p> oudes<section2> ; 

• une<section2> peut avoir pour enfantsdes<p> ou des<section3> ; 

• une<section3> peut avoir pour enfants des <p>. 

Le probleme etant de redonner a chaque element le parent qu'il devrait avoir dans la 
future hierarchie, il fautdonc inverser la relation « a pour enfant » dans la listeci-dessus : 

• un <titreSectioni> devrait avoir pour parent I 'element <document> ; 

• un <titreSection2> ou un <p>#i devrait avoir pour parent I 'element <titreSectioni> 
[-i] ; 

• un <titreSection3> ou un <p>#2 devrait avoir pour parent I 'element <titreSection2> 
[-i] ; 

• un <p>#3 devrait avoir pour parent I 'element <titreSection3>[-i]. 

La notation <p>#i designeici un element <p> qui esttel que si on remontedepuiscet ele- 
ment <p> vers la racine du document, le premier element rencontre qui ne soit pas un <p> 
estun <titreSectioni>. II en va de meme avec <p>#2 et<titreSection2>, avec <p>#3 et 

<titreSection3>. 

La notation <titreSectioni>[-i] designe le premier <titreSectioni> rencontre en 
remontant depuis le nceud contexte vers la racine, ce qui s'exprime techniquement par 
une expression X Path tresclassique : 

preceding-sibling: :titreSectionl[l] 

On a le meme genre d'expression avec <titreSection2>[-i] et<tureSection3>[-i:. 

La seule reelle difficulty de ce programme reside dans I'ecriture d'un motif exprimant la 
notation <p>#n. M ais en procedant progressivement, depuis un node-set contenant tous 
I es elements <p> sans distinction, quel'on filtreen enchainantles predicats adequats, on 
parvient au resultat cherche. 

Voyonscelasurlecasde<p>#i ; il fautpartirde tousles elements <p> : 



On neretientqueceux dont I 'axe preceding-sibling, reduitaux elements non <p>, n'est 
pas vide: 

p[ preceding -sibling: :* [not (self : :p)]] 

Maintenant, on neretientqueceux dont I'axe preceding-sibling, reduitaux elements 
non <p>, n'est pas vide etpossedeun premier element qui estun <titreSectioni> : 

p[preceding-sibling::*[not (self ::p)][l] [self ::titreSectionl]] 
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A rrive a ce stade, on a dequoi initialiser partiellementla de ; on reprend par exemplele 

deuxieme item de I 'enumeration ci-dessus : 

• un <titreSection2> ou un <p>#i devrait avoir pour parent I'element <titreSectioni> 

[-i] ; 
II suffit de transcri re cette phrase en initialisation decle : 

<xsl:key 

name="lesEnfantsDi rects" 
match="titreSection2 | 

p[preceding-sibling::*[not(self::p)][l][self::titreSectionl]]" 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

Des lors, on a tout ce qu'il faut pour terminer le programme completement : 
texte.xsl 



I 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl :stylesheet xmlns:xsl="http://www. w3.org/1999/XSL/Transform" ver: 

<xsl:output method='xml ' encoding=' ISO-8859-1 ' indent='yes' /> 



<xsl :key name="lesEnfantsDi rects" 
match="titreSectionl" 
use="generate-id( parent: : document )" /> 

<xsl :key 

name="lesEnfantsDi rects" 
match="titreSection2 | 

p[preceding-sibling::*[not(self::p)][l][self::titreSectionl]]" 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

<xsl :key 

name="lesEnfantsDi rects" 
match="titreSection3 | 

p[preceding-sibl ing: :*[not( self : :p)][l][self: :titreSection2]]" 
use="generate-id( preceding-sibl ing: :titreSection2[l] )" /> 

<xsl :key 

name="lesEnfantsDi rects" 

match="p[preceding-sibling: :*[not(self : :p)][l][self : :titreSection3]]" 

use="generate-id( preceding-sibl ing: :titreSection3[l] )" /> 
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<xsl :template match="/"> 

<xsl :apply-templates /> 
</xsl :template> 

<xsl : tempi ate match="document" > 
<Document> 

<xsl :apply-templates 

select="key( 'lesEnfantsDirects' , genera te-id( .) )"/> 
</Document> 
</xsl :template> 

<xsl :template match="titreSectionl" > 
<Sectionl> 

<titre><xsl:value-of select="."/X/titre> 
<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , generate- id( .))"/> 
</Sectionl> 
</xsl :template> 

<xsl :template match="titreSection2" > 
<Section2> 

<titre><xsl:value-of select=". °/></titre> 
<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , genera te-id( .))"/> 
</Section2> 
</xsl :template> 

<xsl :template match="titreSection3" > 
<Section3> 

<titre><xsl:value-of select=". °/></titre> 
<xsl :apply-templates 

select="key( 'lesEnfantsDirects' , genera te-id( .) )"/> 
</Section3> 
</xsl :template> 



Elements termini 



<xsl :template match="p" 
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</p> 
</xsl :template> 



</xsl:stylesheet> 

L e resultat est conforme a ce que I 'on a montre au tout debut. 



Maintenant, la question que I 'on pourraitse poser concerne la disproportion entrelafai- 
ble varietedes elements terminaux(uniquementdes<p>),et la complexiteimportantedes 
motifs decle. Si I'on a un texteplusricheen elements terminaux, queva-t-il advenirde 
ces motifs ? 
Supposonsparexemplequ'il puissey avoir des<figure> en plus des <p>, commececi : 



<?xml version="1.0" encoding="UTF-16" ?> 
<document> 

<titreSectionl> titre A </titreSectionl> 
<p> para 1 </p> 
<figure href="A.gif "/> 
<titreSection2> titre A.l </titreSection2> 
<p> para 2 </p> 
<p> para 3 </p> 
<figure href="A.l.gif"/> 
<p> para 4 </p> 
<titreSection2> titre A. 2 </titreSection2> 
<p> para 5 </p> 

<titreSection3> titre A. 2.1 </titreSection3> 
<p> para 6 </p> 
<p> para 7 </p> 
<figure href="A.2.1.gif"/> 
<titreSection2> titre A. 3 </titreSection2> 
<p> para 8 </p> 
<titreSectionl> titre B </titreSectionl> 
<figure href="B.gif "/> 
<titreSection2> titre B.l </titreSection2> 

<titreSection3> titre B.l. 1 </titreSection3> 

<p> para 9 </p> 
<titreSection3> titre B.l. 2 </titreSection3> 
<p> para 10 </p> 
<titreSection2> titre B.2 </titreSection2> 
<p> para 11 </p> 
<figure href="B. 2.gif "/> 
</document> 



L'initialisation partielledelacle prend alors la forme suivante : 

<xsl :key 
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*[self::p or self::figure] 
[preceding-sibling: :* 

[not(self::p)] 

[not(self::figure)] 

[1] 

[self::titreSectionl] 
]" 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

Comparez avec I'initialisation lorsque <p> estleseul element terminal : 

|<xsl :key 
name="lesEnfantsDi rects" 
match="titreSection2 | 

p[preceding-sibling::*[not(self::p)][l][self::titreSectionl]]" 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

On peut ameliorer la comparaison en recrivant cette initialisation de la memefacon : 

si :key 
name="lesEnfantsDi rects" 
match="titreSection2 | 
*[self::p] 

[preceding-sibling: :* 
[not(self::p)] 
[1] 

[self::titreSectionl] 
]" 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

On voit done comment evolue le motif lorsqu'on ajoute des elements terminaux possi- 
bles : globalement, le motif se complexifie, mais sa structure reste tres reguliere, ce qui 
permet done d' envi sager de transformer des textes pi us ri ches que ceux que I ' on a montre 
en exemple. 

Lerestedu programme (I 'etape 2) reste inchangee dans sa structure : leseul endroit delicat 
est I 'ecriture des motifs. 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl:stylesheet xmlns :xsl="http://www. w3.org/1999/XSL/Transform" vers 

<xsl:output nethod= ' xral ' encoding=' ISO-8859-1' indent^'yes' /> 



Reconstitutioi 
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use="generate-id( parent: : document )" /> 

<xsl :key 

name="lesEnfantsDirects" 
match="titreSection2 | 

*[self::p or self::figure] 
[preceding-sibling: :* 
[not(self::p)] 
[not(self::figure)] 
[1] 

[self::titreSectionl] 
]■ 
use="generate-id( preceding-sibl ing: :titreSectionl[l] )" /> 

<xsl :key 

name="lesEnfantsDirects" 
match="titreSection3 | 

*[self::p or self::figure] 
[preceding-sibling: :* 
[not(self::p)] 
[not(self::figure)] 
[1] 

[self::titreSection2] 
]■ 
use="generate-id( preceding-sibl ing: :titreSection2[l] )" /> 

<xsl :key 

name="lesEnfantsDirects" 
match="*[self : :p or self : :figure] 
[preceding-sibl ing: :*[ 
not(self::p)] 
[not(self::figure)] 
[1] 

[self::titreSection3] 
]■ 
use="generate-id( preceding-sibl ing: :titreSection3[l] )" /> 



3 recursif de 1 



<xsl : tempi ate match="/"> 

<xsl :apply-templates /> 
</xsl :template> 

<xsl : tempi ate match="document" ) 
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<d0CL 



;nt> 



</x 



<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , gene rate -i 
</document> 
>1 :template> 



<xsl :template match="titreSectionl" > 
<Sectionl> 

<titre><xsl:value-of select=". VX/titre> 
<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , generate-i 
</Sectionl> 
</xsl :template> 

<xsl :template match="titreSection2" > 
<Section2> 

<titre><xsl:value-of select="."/X/titre> 
<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , generate-i 
</Section2> 
</xsl :template> 

<xsl :template match="titreSection3" > 
<Section3> 

<titre><xsl:value-of select="."/X/titre> 
<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , generate-i 
</Section3> 
</xsl :template> 



<xsl :templ ate match="p" > 

<P> 

<xsl:value-of select="."/> 

</p> 
</xsl :template> 

<xsl :template match="figure" > 
<xsl:copy-of select="."/> 
</xsl :template> 



</xsl:stylesheet> 
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Chapitre 9 

Exemple atypique 

Nous allons maintenant voir un exemple beaucoup plus simple, mais un peu atypique, 
afin de verifier que la structure generale d'un programme de reconstruction hierarchique 
tient debout malgre le changement de contexte destabilisant. 

II s'agitdu fichier company. xmi , evoque au debut decette section sur les regroupements : 

company.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<table name="COMPANY"> 

N0ACA<tab/>CHAR(6Xbr/> 

LSACAKtab/>VARCHAR2(35Xbr/> 

CCPAAKtab/>NUMBER(4Xbr/> 

LAACAKtab/>VARCHAR2(35Xbr/> 

URL<tab/>VARCHAR2(40Xbr/> 

STATRAT<tab/>VARCHAR2( 1 )<br/> 
</table> 

restoredCompany.xml 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<table name="COMPANY"> 
<field> 

<name>NOACA</name> 

<type>CHAR(6X/type> 
</field> 
<field> 

<name>LSACAK/name> 

<type>VARCHAR2 ( 35 )</type> 
</field> 
<field> 

<name>CCPAAK/name> 

<type>NUMBER(4X/type> 
</field> 
<field> 

<narae>LAACAK/name> 

<type>VARCHAR2 ( 35 )</type> 
</field> 
<field> 

<name>URL</name> 

<type>VARCHAR2(40X/type> 
</field> 
<field> 

<name>STATRAT</name> 

<type>VARCHAR2(l)</type> 
</field> 
</table> 

Ce qui est atypique, ici, c'est que ce sont les elements <tat>> qui sont les elements de 
deuxieme niveau, rattaches aux elements <br>, alors qu'ils sont places avant. Bien que 
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cela change un peu del 'habitude, la structure general edu programme de transformation 
reste i ntacte : 



restoredCompany.xsl 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns:xsl="http: //www. w3.org/1999/XSL/Transforn 



<xsl:output method='xmr encoding^' ISO-8859-1' indent='yes' /> 
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<xsl :key name="lesEnfantsDirects" 
match="br" 
use="generate-id( parent : :table )" /> 

<xsl :key 

name="lesEnfantsDi rects" 

match="tab" 

use="generate-id( following-sibl ing: :br[l] )" /> 



<xsl :templ ate match="/"> 

<xsl :apply-templates /> 
</xsl :template> 

<xsl :template match="table" > 
<xsl:copy> 

<xsl:for-each select="attribute: : 

<xsl :copy/> 
</xsl:for-each> 



<xsl :apply-templates 

select="key( 'lesEnfantsDi rects' , genera te-id( .) )"/> 



</xsl :copy> 
</xsl :template> 
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<xsl :apply-templates 

select="key('lesEnfantsDirects', generate-id( . ) )"/> 
<type><xsl :value-of select=" preceding-sibling: :text( )[l]"/X/type> 
</field> 
</xsl :template> 

<! — 

Elements terminaux de la hierarchie 



<xsl :template mat 

<name> 

<xsl:value-of 

</name> 
</xsl :template> 



5-space(preceding-sibl ing: :text( )[!])"/> 



</xsl:stylesheet> 

Le resultat obtenu est le fichier restoredcompany.xmi montreci-dessus. 



Pattern n° 15 - Generation d'une feuille de style par une autre 
feuille de style 

Motivation 

II y a des cas (a priori assezrares) oil I'on tombesurdes limitations du langageXSLT lui 
meme : par exemple, I e fait que seulement certains attributs soient susceptibles d'accep- 
ter des descripteurs de valeurs differees d'attributs ; ou bien le fait qu'une expression ne 
puisse pas etre construite puis interpret.ee dynamiquement. 

U ne solution, lorsque I'on est confronts a cette difficulty consiste a utiliser telle ou telle 
extension proposee par tel ou tel processeur. Mais cette solution, en general, rend le 
programme non portable, ce qui peut ne pas etre acceptable dans certains cas. 

Une autre solution consiste a ecrire une feuille de style qui genere une autre feuille de 
style. 

L'une des difficultes de la mise en ceuvre d'une feuille de style qui en genere une autre, 
est que la feuille de style va contenir des instructions litterales a produire dans le docu- 
ment resultat ; mais il ne faut pas que le processeur X SLT s'apercoive que ces elements 
XML sontdesinstructionsXSLT, sinon il va tenter de I esexecuter. C'est la qu'intervient 
instruction namespace-aiias, qui permet de produi re dans I e document resultat des ele- 
ments X M L dansun domaine nominal different de eel ui qu'ilsavaient dans la feuille de 
style primitive. 
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Une autre difficulty peutaussi survenir, inattendue : c'est qu'unefeuille de style generee, 
c'estbien ; maisunefeuilledestylegenereeetexecut.ee, c'est mieux. 

II est done assez probable qu'en plus degenerer la feuille de style, on veuillegenerer 
un fichier de commande pour lancer I' execution de cette feui 1 1 e de style generee avec 
les bons arguments. Se pose des lors le probleme d'etre capable de produire plus 
d'un fichier resultat. C'est en principe infaisableen XSLT 1.0 ; mais le besoin etant 
reel, des extensions existent avec la plupartdes processeurs XSLT pour permettre la 
production de plusieurs documents resultat. De son cote, le « Working D raft » 
XSLT 1.1 propose d'aj outer une instruction xsi :document, (et cette proposition aete 
reprise dans le Working Draft 2.0) dont I'effet sera de permettre la production de 
plusieurs documents. 
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L'exemple que nous allons voir est la realisation d'un petit interpreteurX Path : une feuille 
de style qui prend en donnee un fichier XML d'essai, et un fichier XML contenant des 
expressions XPath. La feuille de style a ecrire devra generer une feuille de style capable 
d'evaluer les expressions X Path sur le fichier d'essai. 

Voici tout d'abord ces deux fichiers XML: 
BaseProduits.xml 



<?xml version="1.0" encoding="UTF-16"?> 




<BaseProduits> 




<LesProduits> 




<Livre ref="vernesl" NoISBN="193335" gamme="roman" media="papier 


> 


<refOeuvres> 




<Ref valeur="200001slm"/> 




</refOeuvres> 




<Prix valeur="40.5" monnaie="FF"/> 




<Prix valeur="5" monnaie="£"/> 




</Livre> 




<Livre ref="boileaunarcejacl" NoISBN="533791" gamme="roman" 




media="papier"> 




<refOeuvres> 




<Ref valeur="liatlc.bn"/> 




</refOeuvres> 




<Prix valeur="30" monnaie="FF"/> 




<Prix valeur="3" monnaie="£'7> 




</Livre> 




<Enregistrement ref="maraisl" Ref Editeur="LC000280" 




gamme="violedegambe" media 


= "CD 


<refOeuvres> 




<Ref valeur="marais.folies'7> 
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</refOeuvres> 














<Interpretes> 














<Interprete nom="Jo 


nath 


n Dunford" 








<Role xml: 


ang= 


'fr" 


Basse de 


viole </Role 


> 




<Role xml: 


ang= 


'en" 


Bass Viol 


</Role> 






</Interprete> 














<Interprete nom="Syl via 


Abramowicz 








<Role xml: 


ang= 


'fr" 


Basse de 


viole </Role 


> 




<Role xml: 


ang= 


'en" 


Bass Viol 


</Role> 






</Interprete> 














<Interprete no 


11= " Ben jam 


n Perrot"> 








<Role xml: 


ang= 


'fr" 


Theorbe et guitare baroque 


</Role> 


<Role xml: 


ang= 


'en" 


Theorbo a 


id baroque g 


uitar 


</Role> 


</Interprete> 














<Interprete no 


ti="Stepha 


e Fuget"> 








<Role xml: 


ang= 


"fr" 


Clavecin 


</Role> 






<Role xml: 


ang= 


'en" 


Harpsichord </Role> 






</Interprete> 














</Interpretes> 














<Titre 














xml :lang="fr"> Les 


Fol i 


es d 


Espagne et 


pieces ined 


ites 


</Titre> 


<Titre 














xml :lang="en"> Fol 


es d 


Espagne and unedited music 


</Titre> 


<Prix valeur="140" 




aie= 


FFV> 








<Prix valeur="13" 




e=" 


"/> 








</Enregistrement> 














<Materiel ref="HarKarl 


refConstructeur="XL-FZ158BK" g 


amme= 


lecteurCD 












marque="HarKar 


<refCaracteristiqu 


2S> 












<Ref valeur="c 


aracHarKa 


r/> 








</refCaracteristiques> 












<Prix valeur="4500 




naie 


"FF"/> 








<Prix valeur="400" 




aie= 


£"/> 








</Materiel> 














</LesProduits> 














<LesOeuvres> 














</LesOeuvres> 














<LesAuteurs> 














</LesAuteurs> 














<LesGammes> 














</LesGammes> 
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<LesMarques> 
</LesMarques> 
<LesCaracteristiques> 
</LesCaracteristiques> 
</BaseProduits> 

XPathExpressions.xml 

<?xml version="1.0" encoding="UTF-16"?> 

<p res s ions source Fi 1 e= " BaseProdui ts. xml "> 

<XPath 

id="l" 

context Node=" En registrement" 

expression="descendant: : Interprete[attribute: :nom = 

'Sylvia Abramowicz' ]/child: : Role' 
/> 

<XPath 

id="2" 

context Node=" En registrement" 

expression="descendant: : Interprete[position( ) = 2] /attribute: :nom" 
/> 

<XPath 
id="3" 

context Node="BaseProduits" 
expression="descendant: :Livre[attribute: :ref = 'vernesl']/ 

child::Prix/attribute::valf 



context Node=" En registrement" 

expression="descendant: :Titre[attribute: :xml :lang = 'en']" 
/> 

<XPath 

id="5" 

context Node="BaseProduits" 

expression="descendant: : Li vre[attribute: : ref = 'vernesl']/ 

child: :Prix[attribute::monnaie = ' FF' ]/attribute: : valei 
/> 



Pattern n 15 - Generation d'une feuille de style par une autre feuille de style 



Le but est done d'ecrireunefeui lie de style xpathinterpretor.xsi telle que lelancement : 

Ligne de commande 

xpath XPathExpressions.xml 

produise le resultat suivant : 
Resultat 



- contextNode="Enregistrement" 

- expression^ descendant: : Interprete[attribute: :nc 



- contextNode="Enregistrement" 

- expression="descendant::Interprete[position() = 2] /attribute: :nc 

Sylvia Abramowicz 



■ contextNode="BaseProduits" 

- expression="descendant: :Livre[attribute: :ref = 'vernesl']/ 
child: :Prix/attribute:: 
40.5 



- contextNode="Enregistrement" 

- expression="descendant: :Titre[attribute: :xml :lang = ' 
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Folies d'Espagne 



DntextNode="BaseProduits" 

<pression="descendant: :Livre[attribute: :ref = 'vernesl']/ 
child: :Prix[attribute::monnaie = ' FF']/attr1bute: :val 



La commande de lancement que nous venons de voir ne prend en donnee que le nom 
du fichierXM L contenantles expressions a interpreter (qui lui memefournitlenom du 
fichierXML a utilisercommejeu d'essai pourlesevaluationsXPath). Cettecommande 
est en fait un script qui lance le processeur XSLT (Saxon, en I'occurrence), comme 
ceci : 

script Xpath 

java -classpath "C:\Program Files\JavaSoft\SAXON\saxon. jar; " 

com. icl.saxon. Stylesheet -o XPathExpressions.xsl 
XPathExpressions.xml . ./XPathlnterpretor.xsl 

call temp. bat 

Dans ce script, seul le nom de richier en gras est un argument ; tout le reste est constant. 

La feuille de Style XPathlnterpretor.xsl genere la feuille de Style XPathExpres- 
sions.xsl ainsi que lescript temp. bat appele a la fin. 

script temp .bat 

java -classpath "C:\Program Files\JavaSoft\SAXON\saxon. jar; " 

com. icl .saxon. Stylesheet -o out. memo 
BaseProduits.xml XPathExpressions.xsl 

Dans ce script, seul le nom de richier en gras est un argument ; tout le reste est constant. 

Quant a la feuille de style generee, la voici, legerement retouchee dans sa presentation 
pour les besoins de la mise en page : 

XPathExpressions.xsl 

<?xml version="1.0" encoding="IS0-8859-l"?> 

I <aaa: stylesheet xmlns :aaa="http: //www. w3.org/1999/XSL/Transform" xmlns:xsl= 
"http://www.w3.org/1999/XSL/Transform" version="1.0"> 
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<aaa:output method="text" encoding="IS0-8859-l"/> 

<-- ========================= i =========================== --> 

<aaa:template match="/"> 
== id = i === 

<aa a: apply- templates mode="Ml"/> 
== id = 2 === 

<aa a: apply- templates mode="M2"/> 
== id = 3 === 

<aa a: apply- templates mode="M3"/> 
== id = 4 === 

<aaa:apply-templates mode="M4"/> 
== id = 5 === 

<aaa:apply-templates mode="M5"/> 
</aaa:template> 



<aaa :template match="text( )" mode="Ml"/> 
<aaa:template match="text( )" mode="M2"/> 
<aaa:template match="text( )" mode="M3"/> 
<aaa:template match="text( )" mode="M4"/> 
<aaa:template match="text( )" mode="M5"/> 
<-- ========================= 2 ========== 



<aaa:template match="Enregistrement" mode="Ml"> 

-- context Node=" En regi st rement" 

-- expression="descendant: : Interprete[attribute: :nom = 

'Sylvia Abramowicz' ] /child: 
<aaa:for-each select^" descendant: : Interprete[ 

attribute: :nom = 'Sylvia Abramowicz' ]/child: : 
<aaa:value-of select="."/> 

</aaa:for-each> 

</aaa:template> 



<aaa :template match="Enregistrement" mode="M2"> 

-- contextNode="Enregistrement" 

-- expression="descendant::Interprete[position() = 2] /attribute: :nom" 

<aaa:for-each select^" descendant: : Interprete[ 

positionO = 2] /attribute: :nom"> 

<aaa:value-of select="."/> 



Patterns de transformation 



</aaa:for-each> 
</aaa:template> 



<aaa:template match="BaseProduits" mode="M3"> 

-- contextNode="BaseProduits" 

-- expression="descendant: :Livre[attribute: :ref = 'vernesl']/ 

child: :Prix/attribute::valei 
<aaa:for-each select^" descendant: : Livre[ 

attribute: :ref = 'vernesl ' ]/child: :Prix/attribute: :valei 
<aaa:value-of select="."/> 

</aaa:for-each> 

</aaa:template> 



ia:template match="Enregistrement" mode="M4"> 

- contextNode="Enregistrement" 

- expression="descendant : :Titre[attribute: :xml :1 ang = 'en']" 

<aaa:for-each select="descendant: :Titre[attribute: :xml :lang = 
<aaa:value-of select="."/> 



</aaa:for-each> 
</aaa:templ ate> 



<aaa:template match="BaseProduits" mode="M5"> 

-- contextNode="BaseProduits" 

-- expression="descendant: :Livre[attribute: :ref = 'vernesl']/ 

child: :Prix[attribute::monnaie = ' FF' ]/attribute: : 
<aaa:for-each select="descendant: : Li vre[attribute: :ref = 

'vernesl']/child::Prix[attribute::monnaie = ' FF' ]/attribute: :v 
<aaa:value-of select="."/> 

</aaa:for-each> 

</aaa:template> 
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Comme nous I'avons deja dit, I'un des problemes pour generer une telle feuille de style 
est la presence a" instructions litterales XSLT a emettre dans le document resultat. Par 
exemple, la section 2 ci dessus est generee par le fragment de code suivant: 



<!-- 2 --> 

<xsl:for-each select="XPath"> 




<aaa: tempi ate> 




<xsl :attribute name="match">text( )</x: 


si: attribute) 


<xsl :attribute name="mode">M<xsl :valui 


j-of select="(i 


</aaa:template> 




</xsl:for-each> 





On voit que I 'instruction template litterale est dans un domaine nominal prefixe par aaa, 
et different decelui d'XSLT, afin qu'elle ne soit pas prise pour une instruction XSLT a 
executer. 

Ceci impliquebien sflrde declarer le domaine nominal aaa, comme ceci : 

|<xsl :stylesheet 
xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 
xmlns:aaa = "http://machin" 

Le domaine nominal prefixe par aaa n'a aucune importance, n'importe quoi convient 

pOUrVU que Ce ne SOit pas "http://www.w3.org/1999/XSL/Transform". Le Choix de 

"aaa" peut paraitre un peu bizarre, mais on a interet a choisir un prefixe qui s'oppose 
visuellementa "xsi", sinon la feuille de style devient inextricable a relire. 

II fautde plus que dans le document resultat, les instructions XSLT (prefixees par aaa), 
soient dans le domaine nominal d'XSLT. C'est la qu'intervient instruction namespace- 
ai las, qui permet la transposition : 

<xsl : namespace- a 1 ias stylesheet-prefix="aaa" resul t-prefix="xsl "/> 

Encore unefois, notons que les domaines nominaux sont references par leur prefixes, et 
done que cette instruction ne demande pas a changer le prefixe dans le resultat, mais a 
changer le domaine nominal associe au prefixe. En clair, on demande que dans I e resultat, 
le domaine nominal associe a aaa ne soit plus soit "http://machin", mais celui qui est 
actuellement associe a xsi . 

Le resultat est visible ci-dessus : la feuille de style generee contient des instructions X SLT 

prefixees par aaa, maiS Ce prefixe est bi en Celui de "http://www.w3.org/1999/XSL/Trans- 

f orm", tout est done correct pour que la feuille de style soit reellement executable. 

Cela peutsembler desagreable que cette feuille de style n'utilise pas le prefixe xsi ordi- 
nal re ettraditionnel, mais i I fautbien voir qu'elle est generee, et qu'elle n'est pas desti nee a 
etre I ue ou mai ntenue par un etre humai n. 

L'autreprobleme a resoudre est la generation d'un document auxiliaire, dans un fichier a 
part. Pour cela nous utilisons ('instruction xsi: document, qui ne fait encore partie 
d'aucun standard, mais qui figure dans les Working Drafts 1.1 et 2.0. Cette instruction 
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utilise les memes attribute que xsi : output, a part un attri but supplemental, href, dont la 
valeur donne I'URI du fichier de destination du resultat de I'instanciation deson modelede 
transformation. Ici, nousl'utilisonspourgenererlecontenu du fichiertemp.bat : 

<xsl :document href="temp.bat" method="text"> 

<xsl :text>java -classpath "C: Files. jar; " </xsl:text> 

<xsl:text>com.icl .saxon. Stylesheet -o out. memo </xsl:text> 

<xsl :value-of select="/Expressions/@sourceFile"/> 

<xsl :text> XPathExpressions.xsK/xsl :text> 
</xsl :document> 

Nous avons fait le tour des problemes a resoudre pour obtenir une feuille de style qui en 
genere une autre ; le resultat final est montre ci-dessous : 

XPathlnterpretor.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

xmlns:aaa= "http://machin" 

version = "1.1"> <!-- compatibility Saxon 6.5 --> 



<xsl:output method='xml ' encoding^' ISO-8859-1' indent='yes' /> 
<xsl :namespace-alias stylesheet-prefix="aaa" resul t-prefix="xsl "/> 



<xsl :templ ate match='/'> 
<aaa:stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transforn 



<aaa:output method='text' encoding="IS0-8859-l"/> 

<xsl :document href="temp.bat" method="text"> 

<xsl :text>java -classpath "C: Files. jar; " </xsl:text> 
<xsl :text>com.icl .saxon. Stylesheet -o out. memo </xsl:text> 
<xsl :value-of select="/Expressions/@sourceFile"/> 
<xsl :text> XPathExpressions.xsK/xsl :text> 

</xsl :document> 

<xsl :apply-templates/> 
</aaa:stylesheet> 
;1 :template> 

htemplate match=' Expressions'> 
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<aaa:template> 

<xsl [attribute name="match">/</xsl :attribute> 
<xsl:for-each select="XPath"> 
= <xsl:value-of select="@id'7> === 
<aaa : apply- tempi ates> 

<xsl: attribute name="mode">M<xsl :value-of select="@id"/> 
</xsl: attribute) 
</aaa: apply- tempi ates> 
</xsl :for-each> 
</aaa:template> 
<!-- /I --> 



<xsl :for-each select="XPath"> 
<aaa:template> 

<xsl :attribute nan 
<xsl attribute nan 
</xsl:attribute> 
</aaa:templ ate> 
</xsl:for-each> 



<xsl:for-each select="XPath"> 

<aaa:template> 

<xsl attribute name="match"> 

<xsl :val ue-of select= "©context Node "/> 
</xsl:attribute> 

<xsl :attribute name="mode">M<xsl :value-of select=" 
</xsl:attribute> 

- contextNode="<xsl :val ue-of select="@contextNode"/>" 

- expression="<xsl :val ue-of select="@expression"/>" 

<aaa:for-each> 

<xsl attribute name="select"Xxsl :val ue-of select="@e> 

</xsl: attribute) 

<aaa:value-of> 

<xsl rattribute name="select">.</xsl :attribute> 
</aaa:value-of> 

</aaa:for-each> 



'xsl :template> 
:stylesheet> 
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Pattern n° 16- Generation de pages HTML dynamiques 

Motivation 

Avec I'avenementdes applications Internet, il afallu mettreau point des systemes capa- 
blesdegenererdes pages HTML dynamiques. En effet, I'envoi de simples pages HTML 
statiquesesten general tres insuffisant pour une application qui doitextraireou calculer 
des informations (typiquement en provenance d'une base de donnees) et les presenter a 
I'internaute. La generation de pages dynamiques, en general, vient en complement des 
pages stati ques, car i I est bi en rare que tout soi t dy nami que dans une page : i I y a tres sou- 
vent un fond stati que, sur lequel on plaque les donnees dynamiques. Ce pattern va mon- 
trer comment faire pour construire une page dynamique a partir d'un fond statique et de 
donnees auxiliai res. 

Remarque 

Nous avons dejavu un exemple de generation de pages dynamiques, au tout debut, pourdonnerun avant-gout 
du langageXSLT (voirLIn avant-gotit dXSLT, page 9). Mais cette page dynamique etait realisee avec une feuille 
de style simplified (Simplified Stylesheet), dont les possibility en matiere de transformation etde traitementsont 
tres limitees. Ici nous allons voir I'equivalent d'une fa?on plus evoluee, permettantparexempled'envisagerdela 
traduction «ala volee » (voir Pattern n '18 -Localisation d line application, page 533). 

La premiere chose a faire est dedefinirle fond statique, carc'estlui qui vapiloter I'appel 
des donnees dynamiques aux bonsendroits. Le plus simple est ici de prendre un exemple. 
Nous allons supposer que nous voulons afficher une page d'annonce du prochain concert ; 
lefond statique aura I'allure suivante : 

fond.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<html> 

<head> 

<title>Les Concerts Anacreon</title> 

</head> 

<body> 

<H1 align="center"> Concert le <dateConcert/> </Hl> 

<H4 align="center"> <1 ieuConcert/> </H4> 

<H2 align="center"> Ensemble <ensemble/> </H2> 

<listeMusiciens> 

<P> 

<musicien/>, <instrument/> 

</p> 
</listeMusiciens> 

<H3> 



3 de <listeCompositeurs/> 
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</body> 
</html> 

Le fond est done constitue majoritairement de balises HTM L ; cependant, la ou on a 
besoin de valeurs dynamiques, un element non HTM L est la pour redamer une valeur 

(par exemple, <dateConcert/>). 

U ne des difficulty pouvant se apparaitre dans un tel contexte, e'est la presence de don- 
nees a repeter un certain nombre de fois, nombre qui est naturellement inconnu a cet 
endroit. Nous avons illustre ceci avec la liste des musiciens a faire figurer : on nesaitpas 
combien il y en a, mais ce qu'on sait, e'est que chaque musicien doit etre mentionne avec 
son nom et son instrument. On doit done ici se contenter de definir comment doit appa- 
raitre une des lignes d'affichage de musicien : 

<p> unNomDeMusicien, leNomDeSonlnstrument </p> 

C'estcequi estexprimeparlebloc : 



<listeMus- 


iciei 


<P> 




<musii 


</p> 




</listeMu: 


sicit 



Avant devoir comment mettreau point une transformation XSLT adequate, remarquons 
tout de suite que cette facon de proceder est conforme a I 'idee generale de la separation 
des competences que I 'on essayetoujoursd'obtenirdanslamiseau point d'une applica- 
tion Internet; ici un graphiste sans competence particuliere en programmation XSLT 
pourra parfaitementecrire lefond statique, avec les appels de donnees dynamiques. 

Cefond statique va done appeler des donnees dynamiques ; dans la pratique, avec un serveur 
d'application commeWeb Logic deBEA ou d'autresdu meme genre, il estassez peu proba- 
ble que ces donnees dynamiques soient placees dynamiquement dans un fichier. En fait, les 
donnees sont en memoire sous forme d'objets, et le processus va consister a construire un 
arbreDOM (Document Object Model) avec ces objets. 

Note 

Un arbre DOM n'estrien d'autre qu'une implementation particuliere de I'arbre XML d'un documentXML 

Une fois I'arbre DOM construit, il est strictement equivalent a un document XM L, du 
point devuedu processeurXSLT. Le serveur d'application (la servleten cours) va done 
activer le thread du processeur XSLT resident (charge avec les autres servlets par le ser- 
veur d'application) en lui transmettant I'URI du fichier statique a traiterainsi que I'arbre 
DOM des donnees dynamiques, ce qui est faisable avec I'API TrAX (Transformation 
API for XML), reprise dans J AX P deSUN (Java A PI for XML). Onseretrouvealors, du 
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point devueXSLT, avec deux sources XM L, une source principale, et une source auxi- 
liaire accessible par un appel a la fonction documents ). 

Mais pour simplifies nous supposerons ici que nous avons deux sources XML sous 
forme de fichiers, le seul probleme etant de real i ser la transformation qui va donner la 
pagedynamique. 

Le fichier auxiliaire des donnees est le suivant : 

Annonce.xml 

<?xml version="1.0" encoding="UTF-16"?> 



<Date> 

<Jour>Jeudi</Jour> 

<Quantieme>17</Quantieme> 

<Mois>janvier</Mois> 

<Annee>2002</Annee> 

<Heure>20H30</Heure> 
</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble>A deux violes esgales</Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 
<Instrument>Basse de viole</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 
<Instrument>Theorbe</Instrument> 

</Interprete> 

<Interprete> 

<Nom> Freddy Eichelberger </Nom> 
<Instrument>Clavecin</Instrument> 

</Interprete> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
</Compositeurs> 
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Realisation 



Lefichier principal est lefichier statique, car il estfait pour piloter I'appel desdonnees 
dynamiques. L efichierresultat (la page dynamique) est I a page statique, dans laquelle les 
appels de valeurs sont remplaces par leur valeur : nous sommes done dans un cas typique 
d'utilisation du pattern « copie non conforme ». 

L'idee de base, ici, est que par defaut, les elements doivent etre recopies sans modifica- 
tion ; nous al Ions done adopter la regie avecpriorite basse vue a la section Copie conforme 
gene'rique, page 444 : 

<xsl :template match="child: :node() | attribute: :*" pri on" ty="-10"> 
<xsl :copy> 

<xsl :apply-templates select="attn'bute: :*" /> 
<xsl :apply-templates select="child: :node( )" /> 
</xsl :copy> 
</xsl:template> 

Cette regie est a contredire uniquement pour les elements qui constituent un appel de 
valeur dynamique. Dans notre cas, cela concerne les elements <dateConcert/>, <iieu- 

Concert/>, <ensemble/>, <1 i steMusi ciens>, <musicien/>, <i nstrument/>, <listeCom- 

positeurs/>. II va done falloir une regie sped fique pour chacun d'eux. 

LeS elements <dateConcert/>, <1 ieuConcert/>, <ensemble/>, et <1 i steCompositeurs/> 

ne posent pas de probleme parti culier et reposent tous sur le meme model e ; leur traitement 
necessite d'avoir acces a la source XML secondaire : 

<xsl :param name="annonceFileRef ">Annonce.xml</xsl :param> 

<xsl variable name="Annonce" select="document($annonceFileRef )/Annonce"/> 

<xsl :template match='dateConcert'> 

<xsl :value-of select="$Annonce/Date/Jour" /> 
<xsl:text> </xsl:text> 

:e/Date/Quantieme" /> 



<xsl:value-of select="$Annonce/Date/Mois" /> 
<xsl:text> </xsl:text> 



<xsl :value-of select="$Annonce/Date/Annee" /> 
<xsl:text> </xsl:text> 

<xsl:value-of select="$Annonce/Date/Heure" /> 

</xsl :template> 

<xsl :template match='l ieuConcert'> 

<xsl :value-of select="$Annonce/Lieu" /> 
</xsl: template) 
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<xsl :template match='ensemble'> 

<xsl :value-of select="$Annonce/Ensemble" /) 
</xsl :templ ate> 

<xsl : tempi ate match='l isteCompositeurs '> 

<xsl :value-of select="$Annonce/Compositeurs 
</xsl :templ ate> 



L'element <iisteMusiciens> est un peu plus complique a mettreau point. II faut copier 
son model ede transformation, asavoir : 



</p> 

autant de fois que I 'on va trouver l'element <interprete> dans le document 
Annonce.xmi, puisqu'il faudra bien qu'il y ait autant de <p> ... </p> quedemusiciens. 
Done la regie vacommencer par un <xsi :for-each> pour traiter I e node-set des <inter- 
prete> du document auxiliaire : 

<xsl : tempi ate match='l isteMusiciens'> 

<xsl :for-each select="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 

</xsl:for-each> 
</xsl :template> 

La variable current-interprete conserve le nceud courant, e'est-a-dire l'<inter- 
prete> courant, car I'experience montre qu'on a frequemment besoin de se reperer 
par rapport au nceud courant dans une instruction <xsi :for-each> ; et memesi cette 
variable n'est pas indispensable, el le permet de mieux s'y retrouver pour construire 
la regie. 

M ais n'oublions pas que la regie doit instancier n fois le modele de transformation 
indique plus haut ; I'unedeces instanciations peutsefairepar un <xsi :copy>, a condi- 
tion que le nceud contextesoit place sur l'element <p>. Or la ou il y a les points de sus- 
pension, dans la regie ci-dessus, le nceud contexte n'est pas place sur <p>, parce que 
i'instruction <xsi :for-each> deplace le nceud contexte sur le nceud en cours. Le nceud 
contexte, acetendroit, est done place dans I'arbreXM L du document auxiliaire, sur le 
nceud <interprete> courant, celui qui precisement, est reference par la variable 

current-interprete. 

Pour remettre le nceud contexte sur l'element <p> afin de permettre la copie, il n'y a 
qu'uneseule solution : utiliseranouveau un <xsi :for-each>, puisque C est la seule ins- 
truction capable de deplacer le nceud contexte. Pour cela, il faut sauvegarder le nceud 
courant a I 'entree de la regie (1), puis selectionner son enfant direct <p> (2) : 

<xsl template match="l isteMusiciens'> 

<xsl variable name="current-l isteMusiciens" select="."/> <!— (1) — > 
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<xsl :for-each select="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 
<xsl:for-each select="$current-l isteMusiciens/p"> <!-- (2) --> 
<xsl :copy> 

</xsl :copy> 
</xsl:for-each> 
</xsl:for-each> 
</xsl : tempi ate> 

Nous avonsmaintenantune regie presque complete; I 'instruction <xsi :copy> va copier 
I 'element <p>, mais les elements enfants de <p> sont des elements non HTML, qui doi- 
ventfaire I'objet d'une regie specifique, du meme genre que celle de <iieuConcert/>, 
par exemple. II est done necessai red 'avoir un <xsi :appiy-tempiates> la ou setrouvent 
les points de suspension, ci-dessus: 

ns'> 

iciens" select="."/> 

<xsl :for-each select="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 
<xsl : for- each select="$current-l isteMusiciens/p"> 
<xsl :copy> 

<xsl :apply-templates/> 
</xsl :copy> 
</xsl:for-each> 
</xsl:for-each> 
</xsl :template> 

<xsl : tempi ate match='musicien'> 

<xsl:value-of select^"???" /> 
</xsl :template> 

L'idee est bonne, car apres avoir copie I 'element <p>, instruction <xsi :appiy-tempiates> 
va effectivement selectionner ses enfants directs (e'est-a-dire I'element <musicien/>, le 
texte ' , "' (virgule, espace, guillement) et I'element <instrument/>, (plus eventuelle- 
mentdes noeuds texte ne contenant que des espaces blancssans interet), etdonc la regie 

<xsl :ternplate match='musi cien '> va etre Selection nee. 

Le probleme, e'est que dans cette regie, on est cense instancier le nom d'un musicien ; 
malheureusement, le musicien en question, on I'a perdu. II etait dans la variable 
current- interprete qui est desormais inaccessible. Inaccessible? Pas tout a fait: ('ins- 
truction <xsi :appiy-tempiates> autorise la transmission d'arguments. C'est assez rare 
d'avoir a utiliser cette possibilite, mais la, c'est le moment ou jamais : 



<xsl :for-each select="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select=". 
<xsl :for-each select="$current-l isteMusiciens/p"> 
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<xsl :copy> 

<xsl :apply-templates> 

<xsl :with-param name="interprete" 

select="$current-Interprete" /> 
</xsl :apply-templates> 
</xsl :copy> 
</xsl :for-each> 
</xsl:for-each> 
</xsl :template> 

<xsl :template match='musicien'> 

<xsl:param name="interprete"/> 

<xsl :value-of select="$interprete/Nom" /> 
</xsl :template> 

Du coup, la regie specifique pour l'<instrument/> va pouvoir etre faite sur le meme 
modele, puisque elle sera selectionne elleaussi par lememe<xsi :appiy-tempiates> : 

<xsl :template match=' instruments 

<xsl :param name="interprete"/> 

<xsl :value-of select="$interprete/Instrument" /> 
</xsl: template) 

M ais que va-t-il advenir du nceud text contenant " . - ? Le processeur va chercher 
une regie a lui appliquer, nevapasen trouver, etvadonc appliquer la regie par defaut 
(voir Regies par defaut pour un nceud de type text ou attribute, page 120) pour les 
nceuds text. Or cette regie par defaut ne prend pas de parametre en donnee, alors que 
I 'instruction <xsi :appiy-tempiates> responsable de I'activation de cette regie en a 
transmis un. Ceci n'est pas une erreur (voir la section Semantique, page 234), et heu- 
reusement, parce que sinon, cela compliquerait diablement les choses s'il fallait 
eviter cette situation. 

On peut done maintenant rassembler les morceaux pour obtenir le programme complet : 

AnnonceConcert.xsl 

| <?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns :xsl="http: //www. w3.org/1999/XSL/Transform" 
version="1.0"> 

<xsl:output method='html ' encoding='IS0-8859-l' /> 

<xsl :param name="annonceFileRef ">Annonce.xmK/xsl :param> 

<xsl :variable name="Annonce" select="document($annonceFileRef )/Annonce"/> 

<xsl : tempi ate match=" child: :node( )] attribute: :*" priori ty="-10"> 
<xsl:copy> 

<xsl :apply-templates select="attribute: :*" /> 

<xsl :apply-templates select^" child: :node()"/> 
</xsl :copy> 
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</xsl :template> 

<xsl :template match='dateConcert'> 

<xsl :val ue-of select="$Annonce/Date/Jour" /> 
<xsl :text> </xsl :text> 

<xsl :val ue-of select="$Annonce/Date/Quantieme" /> 
<xsl :text> </xsl :text> 

<xsl :val ue-of select="$Annonce/Date/Mois" /> 
<xsl :text> </xsl :text> 

<xsl :value-of select="$Annonce/Date/Annee" /> 
<xsl :text> </xsl :text> 

<xsl :value-of select="$Annonce/Date/Heure" /> 

</xsl :template> 

<xsl :template match='lieuConcert'> 

<xsl :value-of select="$Annonce/l_ieu" /> 
</xsl :template> 

<xsl : tempi ate match='ensemble'> 

<xsl :value-of select="$Annonce/Ensemble" /> 
</xsl :templ ate> 

<xsl: tempi ate match='listeMusiciens'> 

<xsl :variable name="current-l isteMusiciens" select="."/> 

<xsl :for-each select="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 

<xsl :for-each select="$current-l isteMusiciens/p"> 

<xsl :apply-templates> 

<xsl :with-param name="interprete" 

select="$current-Interprete" /> 
</xsl :apply-templates> 
</xsl :copy> 
</xsl:for-each> 
</xsl:for-each> 
</xsl :template> 

<xsl : tempi ate match='musicien'> 
<xsl : param name="interprete"/> 
<xsl :val ue-of select="$interprete/Nom" /> 
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</xsl :template> 

<xsl :template natch='instrument'> 
<xsl:param name="interprete"/> 
<xsl :value-of select="$interprete/Instrument" /> 

</xsl :template> 

<xsl :template match='listeCompositeurs'> 

<xsl :value-of select="$Annonce/Compositeurs" /> 
</xsl :template> 

</xsl:stylesheet> 

Etvoici le resultat obtenu : 

Annonce.html 

<html> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8£ 

<title>Les Concerts Anacréon</title> 
</head> 
<body> 

<H1 align="center"> Concert le Jeudi 17 Janvier 2002 20H30 </Hl> 

<H4 align="center"> Chapelle des Ursules </H4> 

<H2 al ign="center"> Ensemble A deux violes esgales </H2> 

<P> 

Jonathan Dunford , Basse de viole 



Sylvia Abramowicz , Basse de viole 
</p> 
<P> 

Benjamin Perrot , Théorbe 
</p> 



Freddy Eichelberger , Cla\ 



Oeuvres de 
M. Marais, D. Castello, F. Rognor 
</H3> 
</body> 
</html> 



Dans le fichier ci-dessus, les lignes blanches ontete enlevees pour gagner de la place ; le 
rendu HTML estmontreala figure 9-4. 
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Aspect de la page 
dynamiqueobtenue. 



Liens | 



Concert le Jeudi 17 Janvier 2002 20H30 

Ch^elle des Ursules 

Ensemble A deux violes esgales 

In 3 , Du ifon Ba e viol 



Fred*? Eichelberget , Clavecin 

Oeuvres de M. Marais, D. Castello, F. Rognoni 

g Ten** 



Conclusion 

Le pattern que nous venons de voir permet de generer des pages HTML dynamiques, 
mais il ne faut pas croire que ce soit la seule application possible. Par exemple, sur le 
meme principe, on peut construire un generateur de classes Java, qui utilise des fonds 
statiquesdece style: 

Measure.tmpl 

<?xml version="1.0"?> 
<template> 



// stored Measure <MeasureName/> 



protected <MeasureType/> <MeasureName/>; 



public final <MeasureType/> get<MeasureNan 
return <MeasureName/>; 



/oid set<MeasureNamewithCapital/>( 

<MeasureType/> <aMeasureName/> ){ 
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super. setAttribute("<MeasureName/>", <aMeasureName/>.toString( ) ); 

<MeasureName/> = <aMeasureName/>; 

Assertion. ensure( get<MeasureNamewithCapital/>( ) == <aMeasureName/> 



</templ ate> 

L e generateur construit une classej ava en assemblant un certain nombre de petites pieces 
de puzzle comme eel lemontreeci-dessus (I 'element <tempiate>), ou I es elements XM L 
sontdes appels devaleurs, exactement comme dans le fichier fond.xmi utilise en exem- 
ple pour la generation de pages HTML dynamiques. Les« valeurs» sontobtenues dans 
des fichiers XML source auxiliaires qui derivent des differentes phases anterieures de 
modelisation, comme on peuten avoir un apercu dans I'extraitci-dessous : 

Entity .xml 

<Entity name="Contract" persistance="simple" IHMconnected="true"> 

<MeasureRef id="beginningDate" /> 

<MeasureRef id="contractNbr" isPartOfKey="yes" /> 

<MeasureRef id="type" /> 
</Entity> 

<Entity name="Country" persistance="simple" > 

<MeasureRef id="countryCode" isPartOfKey="yes" /> 

<MeasureRef id="zoneEuro" /> 
</Entity> 

<Measure name="contractNbr" type="String" access="stored" /> 
<Measure name="type" type="String" access="stored" /> 
<Measure name="coefficient" type="String" access="stored" /> 
<Measure name="countryCode" type="String" access="stored" /> 
<Measure name="zoneEuro" type="Boolean" access="stored" /> 
<Measure name="beginningDate" type="BusinessDate" access="stored" /> 
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pourun portail 

Le pattern que nous al Ions voir ici reprend I e precedent, en lemodifiantlegerementpour 
montrer comment generer une page dynamique pour un portail. Cequi va changer, e'est 
lefaitqu'il ne va plusy avoir un seul fichier XM L auxiliairede description des donnees, 
maisplusieurs. Eneffet, dansun portail, il y amultituded'informationsrassembleesdans 
une seule page, et ces informations ne proviennent pas toutes du meme fichier, evidem- 
ment. II y a done denombreuses sources XM L a exploiter eta synthetiser dans la genera- 
tion dynamique de la page. Pour les besoins de I'exemple, nous aurons deux sources 
XML, et ce n'est plus le programme XSLT qui connait d'avance le nom des fichiers 
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XML a consulter, mais c'est le fond statique qui I'indique, avec des balises modifiees 
comme ceci : 

fond.xml 

<?xml version="1.0" encoding="UTF-16"?> 
<html> 

<head> 

<title>Les Concerts Anacreon</title> 

</head> 

<body> 

<H1 align="center"> Concert le <dateConcert href="Annonce.xml "/> </Hl> 

<H4 align="center"> OieuConcert href="Annonce.xml "/> </H4> 

<H2 align="center"> Ensemble <ensemble href="Annonce.xml"/> </H2> 

<1 isteMusiciens href="Annonce.xml "> 

<P> 

<musicien/>, <instrument/> 

</p> 
</listeMusiciens> 



Reservations : Reservations href="Reservatic 
</p> 



Ce fond contient desormais des balises qui font reference aux fichiers XML a exploiter 
pour aller chercher les valeurs a placer dynamiquement. Le fichier Annonce.xmi reste 
identique a ce qu'il etait a la section precedente (voir Pattern n° 16 -Generation de pages 
HTML dynamiques, page518). Le fichier Reservations. xmi contient les informations 
suivantes : 

Reservations .xml 

<?xml version="1.0" encoding="UTF-16"?> 

<Reservations> 

<Reservation> 

<Lieu>Chapelle des Ursules</Lieu> 

<Tel>02 41 11 12 13 14</Tel> 
</Reservation> 
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<Reservation> 

<Lieu>Anacreon</Lieu> 

<Tel>02 41 99 97 98 99</Tel> 
</Reservation> 

<Reservation> 

<Lieu>FNAK</Lieu> 

<Tel>02 41 00 97 98 99</Tel> 
</Reservation> 

Reservation 

La consequence est que le programme X SLT ne doit plus creer une fois pour toutes une 
variable contenant la source auxiliaire, mais doit pouvoir changer de source eventuel- 
lementachaqueregle: 

AnnonceConcert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 



<xsl:output method='htmr encodings' IS0-8859-1' /> 

<xsl : tempi ate match=" child: :node( )] attribute: :*" priori ty="-10"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*" /> 
<xsl :apply-templates select^" child: :node()"/> 
</xsl :copy> 
</xsl :template> 

<xsl :template match='dateConcert'> 

<xsl :variable name="Annonce" select="document(@href )/Annonce' 

<xsl :value-of select="$Annonce/Date/Jour" /> 
<xsl :text> </xsl :text> 



:value-of select="$Annonce/Date/Mois" /> 
:text> </xsl:text> 

:e/Date/Annee" /> 

<xsl:value-of select="$Annonce/Date/Heure" /> 
<sl :template> 
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<xsl : template match='lieuConcert'> 

<xsl :variable name="Annonce" select="document(@href )/Annonce"/> 

<xsl :value-of select="$Annonce/l_ieu" /> 
</xsl :template> 

<xsl : tempi ate match='ensemble'> 

<xsl : variable name="Annonce" sel ect=" document (@href)/Annonce"/> 

<xsl :val ue-of select="$Annonce/Ensemble" /> 
</xsl :templ ate> 

<xsl template match=' 1 isteMusiciens '> 

<xsl :variable name="Annonce" select="document(@href )/Annonce"/> 
<xsl variable name="current-l isteMusiciens" select="."/> 

<xsl :for-each select="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 

<xsl :for-each select="$current-l isteMusiciens/p"> 
<xsl :copy> 

<xsl :apply-templates> 

<xsl :with-param name="interprete" 

select="$current-Interprete" /> 
</xsl :apply-templates> 
</xsl :copy> 
</xsl:for-each> 
</xsl:for-each> 
</xsl :template> 

<xsl :template match='musicien'> 

<xsl:param name="interprete"/> 

<xsl :value-of select="$interprete/Nom" /> 
</xsl :templ ate> 

<xsl : tempi ate match=' instruments 

<xsl:param name="interprete"/> 

<xsl :value-of select="$interprete/Instrument" /> 
</xsl :template> 

<xsl :template match='listeCompositeurs '> 

<xsl variable name="Annonce" select="document(@href )/Annonce"/> 
<xsl :value-of select="$Annonce/Compositeurs" /> 

</xsl : tempi ate> 

<xsl : tempi ate match=' reservations '> 
<xsl :variable name="reservations" 

select="document(@href)/Reservations"/> 
<xsl :for-each select="$reservations/Reservation"> 
<br/> 
<xsl:for-each select="*"> 

<xsl :value-of select^"." /> 

<xsl:if test="position() != last()"> 
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</xsl:for-each> 
</xsl :for-each> 
</xsl :template> 

7xsl:stylesheet> 

Commeonpeutlevoir, leschangementsapportessonttresmodestes: il suffitdesupprimer 
la declaration de variable globale, et de placer une declaration equivalente dans chaque 
regie dontle motif concorde avec une balise susceptible d'avoir un attri but href. 

La regie pour traiter les reservations ne prejuge pas du contenu du fichier Reserva- 
tions, xmi : la seule chose qui soitdemandee, c'estqu'il y ait un ou plusieurs elements 
<Reservation>, et cela suffit pour que le contenu de ces elements soit affiche. 

Voici le resultat obtenu (sans les lignes blanches inutiles) : 

AnnonceConcert.html 

<html> 

<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-l"> 
<title>Les Concerts Anacréon</title> 
</head> 
<body> 

<H1 align="center"> Concert le Jeudi 17 Janvier 2002 20H30 </Hl> 

<H4 align="center"> Chapelle des Ursules </H4> 

<H2 al ign="center"> Ensemble A deux violes esgales </H2> 

<P> 

Jonathan Dunford , Basse de viole 
</p> 
<P> 

Sylvia Abramowicz , Basse de viole 
</p> 
<P> 

Benjamin Perrot , Théorbe 
</p> 
<P> 

Freddy Eichelberger , Clavecin 



Oeuvres de 
M. Marais, D. Castello, F. Rognor 
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Pattern n° 18- Localisation d'une application 

Motivation 

U n produi t etant de pi us en pi us souvent concu pour etre vendu dans I e monde enti er, i I faut 
eventuellement, suivant sa nature, le « localiser » pour pouvoir le vendre. La localisation 
consiste a adapter le produit aux us et coutumes du pays vise, I'aspect le plus evident de 
cette adaptation portant sur la traduction des textes a presenter a I'utilisateur final. 

Un cas parti culier extremement frequent de localisation est eel le qui consiste a adapter 
une application Internet a la langue (voire a la legislation ...) du pays de I'utilisateur iden- 
tifie. LorsqueXSLT est utilise pour generer des pages HTM L dynamiques (commedans 
le pattern que I'on vient devoir), il est souhaitablede realiser la localisation simultane- 
ment. N ous allons done reprendre exactement le meme exemple que precedemment, et le 
meme pattern degeneration dynamiquede pages HTM L, en lui associantun dictionnaire 
de traduction en fonction d'une langue cible. 



Realisation 



L e pri nci pe est I e meme que pour I e pattern degeneration de pages HTM L dynamiques ; 
nous allons done reprendre lefichier fond.xmi tel qu'il etaita la section Pattern n°16 - 
Generation de pages HTM L dynamiques, page 518, maisen lemodifiantpour remplacer 
touttexte litteral par un appel de valeur permettant la traduction : 

fond.xmi 



<?xml version="1.0" encoding="UTF-16"?> 
<html> 

<head> 

<title>Les Concerts Anacreon</title> 

</head> 

<H1 align="center"> <concertLe/> <dateConcert/> </Hl> 
<H4 align="center"> <1 ieuConcert/> </H4> 
<H2 align="center"> <ensemble/> </H2> 



<listeMusic 


iens> 




<P> 






<mu 


sicien/>, 


<instrument/> 


</p> 






</l isteMusn 


ciens> 




<H3> 


sDe/> 




<listeCompositeur 


s/> 


</H3> 






</body> 






</html> 
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La traduction proprementdite a dejaetevue (voir la section Exemple, page 223) ; il suffit 
done de reprendre cette technique de traduction et de I'associer au pattern « Generation 
de pages HTM L dynamiques». Voici lefichier source auxi I i aire: 



Annonce.xml 

<?xml version="1.0" encoding="UTF-16"?> 



<Date> 

<Jour id="jeu'7> 

<Quantieme>17</Quantieme> 

<Mois id="jnv'7> 

<Annee>2002</Annee> 

<Heure>20H30</Heure> 
</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble>A deux violes esgales</Ensemble> 

<Interprete> 

<Nom> Jonathan Dunford </Mom> 

instrument id="bvl"/> 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 

instrument id="bvl"/> 
</Interprete> 

<Interprete> 

<Nom> Benjamin Perrot </Nom> 

<Instrument id="thb"/> 
</Interprete> 

<Interprete> 

<Nom> Freddy Eichelberger </Nom> 

instrument id="clv"/> 
</Interprete> 

<Compositeurs> 

M. Marais, D. Castello, F. Rognoni 
</Compositeurs> 
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La traduction estbaseesurun dictionnaire, qui doit comporterun equivalent dans chaque 
langue des appels de valeurs presents dans lefond statique : 



Dictionnaire.xml 

<?xml version="1.0' 

<Dictionnaire> 
<mot id="bvl "> 
<traductior 
<traductior 
</mot> 



<mot id="vdg"> 
<traductior 
<traductior 

</mot> 



; de gambe</traduction> 
a da gamba</traduction> 



<mot id="lth"> 
<traductior 
<traductior 

</mot> 



<mot id="clv"> 
<traductior 
<traductior 

</mot> 



lang="fr">Clavecin</traduction> 
I ang= "en ">Harpsichord</ traduction 



<mot id="flt"> 
<traductior 
<traductior 

</mot> 



I ang="f r">Fl ute a bec</traduction 
lang="en">Recorder</traduction> 



<mot id="thb"> 
<traductior 
<traductior 

</mot> 



lang="fr">Theorbe</traduction> 
lang="en">Theorbo</traduction> 



<mot id="lun"> 
<traductior 
<traductior 

</mot> 



lang="fr">l undi</traduction> 
lang="en">monday</traduction> 



<mot id="jeu"> 
<traductior 
<traductior 

</mot> 



lang="f r">jeudi</traduction> 
lang="en">thursday</traduction> 
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<mot id="jnv"> 

traduction lang="fr">janvier</traduction> 
traduction lang="en">january</traduction> 

</mot> 

<!-- etc. (les autres mois de 1'annee) --> 

<mot i d="dcb"> 

traduction 1 ang="fr">decembre</traduction> 
<traduction lang="en">december</traduction> 

</mot> 

<mot id="concertLe"> 

traduction lang="f r">Concert le</traduction> 
traduction lang="en">Concert on</traduction> 

</mot> 

<mot id="oeuvresDe"> 

<traduction lang="fr">Oeuvres de</traduction> 
<traduction 1 ang="en">Works by</traduction> 

</mot> 

<mot id="MarqueQuantieme"> 

traduction 1 ang="fr"X/traduction> 
<traduction lang="en">th</traduction> 

</mot> 



Le programme XSLT est une adaptation du programme precedent, danslequel on integre 
des appels a un modele nomme de traduction : 

Annonce.xsl 

<?xml version="1.0" encoding="UTF-16"?> 

<xs1: stylesheet xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 



<xsl:output method='html ' encodings' ISO-8 



i="langueCible">fr</xsl :param> 
i="dicoFileRef">dictionnaire.xml</xsl:param> 
!="annonceFileRef">Annonce.xml</xsl :param> 

iame="Dictionnaire" 

;elect="document($dicoFileRef)/Dictionnaire' 

iame="Annonce" 

;elect=" document ($annonceFileRef)/Annonce"/: 
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<xsl :template name="instancier-traduction"> 
<xsl:param name="motId'7> 

<xsl:variable 

name="motTrouve" 
select="$Dictionnaire/mot[@id=$motId]" /> 

<xsl. -variable 

name="saTradiiction" 
select="$motTrouve/traduction[@lang=$langueCible]" /> 

<xsl:value-of select="$saTraduction" /> 
</xsl :template> 

<xsl template match="chi Id: :node( ) | attribute: :*" priori ty="-10"> 
<xsl :copy> 

<xsl :apply-templates select="attribute: :*" /> 
<xsl : apply- templates select=" child: :node( )"/> 
</xsl :copy> 
</xsl :template> 

<xsl : tempi ate match='concertLe'> 

<xsl :cal 1 -tempi ate name="instancier-traduction"> 

<xsl :with-param name="motId" select=" 'concertLe' " /> 

</xsl : call -tempi ate> 

<xsl:text> </xsl:text> 
</xsl :template> 



:template name='instancier-Date'> 



<xsl:param name="Quantieme'7> 
<xsl:param name="Mois"/> 
<xsl:param name="Annee"/> 

<xsl :choose> 

<xsl :when test="$langueCible = 'fr'"> 
<xsl :value-of select="$Jour"/> 
<xsl:text> </xsl:text> 
<xsl:value-of select="$Quantieme"/> 
<xsl:text> </xsl:text> 
<xsl:value-of select="$Mois"/> 
<xsl:text> </xsl:text> 
<xsl :value-of select="$Annee"/> 

<xsl :when test="$langueCible = 'en'"> 
<xsl :value-of select="$Jour"/> 
<xsl :text>, the </xsl :text> 
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<xsl :value-of select="$Quantieme"/> 
<xsl:text>th of </xsl :text> 
<xsl :value-of select="$Mois"/> 
<xsl:text>, </xsl:text> 
<xsl :value-of select="$Annee"/> 
(si :when> 



<xsl :template match='dateConcert'> 

<xsl : call -template name="instancier-Date"> 



<xsl :with-param name="Jour"> 




<xsl :cal 1 -template name="instancier-traduction"> 




<xsl :with-param name="motId" 




select="$Annonce/Date/Jour/@id' 


/> 


</xsl :call -template> 




</xsl:with-param> 




<xsl :with-param name="Quantieme"> 




<xsl :value-of select="$Annonce/Date/Quantieme" /> 




</xsl :with-param> 





<xsl:with-param name="Mois"> 

<xsl :cal 1 -template name="instancier-traduction"> 
<xsl :with-param name="motId" 

select="$Annonce/Date/Mois/@id" /> 
</xsl :call -template> 
</xsl :with-param> 

<xsl :with-param name="Annee"> 

<xsl :value-of select="$Annonce/Date/Annee" /> 
</xsl :with-param> 

</xsl : call -tempi ate> 



</xsl :template> 

<xsl : tempi ate match='l ieuConcert'> 

<xsl :value-of select="$Annonce/Lieu" /> 
</xsl :template> 

<xsl :template match='ensemble'> 
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<xsl :value-of select="$Annonce/Ensemble" /> 
</xsl :template> 

<xsl : tempi ate match='listeMusiciens '> 

<xsl :variable name="current-l isteMusiciens" select="."/> 

<xsl :for-each select="$Annonce/Interprete"> 

<xsl :variable name="current-Interprete" select="."/> 

<xsl : for- each select="$current-l isteMusiciens/p"> 

<xsl :apply-templates> 

<xsl :with-param name="interprete" 

select="$current-Interprete" /> 
</xsl :apply-templates> 
</xsl :copy> 
</xsl:for-each> 
</xsl:for-each> 
</xsl :template> 

<xsl : tempi ate match='musicien'> 

<xsl:param name="interprete"/> 

<xsl :value-of select="$interprete" /> 
</xsl :templ ate> 

<xsl :template match=' instrument '> 
<xsl :param name="interprete"/> 
<xsl:text> </xsl:text> 

<xsl :cal 1 -tempi ate name="instancier-traduction"> 

<xsl :with-param name="motId" select="$interprete/Instrument/@id" /> 
</xsl:call -template) 
</xsl :template> 



<xsl :template match='oeuvresDe'> 

<xsl :call-template name="instancier-traduction"> 

<xsl :with-param name="motId" select=" 'oeuvresDe'" /> 

</xsl: call -tempi ate> 

<xsl :text> </xsl :text> 
</xsl :templ ate> 

<xsl : tempi ate match='listeCompositeurs '> 

<xsl :value-of select="$Annonce/Compositeurs" /> 
</xsl :template> 



</xsl: stylesheet) 
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Chapitre 9 

Leresultatobtenu avec leparametreianguecibie=en est montrea la figure 9-5. 



Figure 9-5 

Aspect de la page 
dynamique traduite 
en anglais. 



Concert on thursday, the 17th of 
January, 2002 - 20H30 

Chajelle des Ursulas 

A deux violes esgales 

Jonathan Dunfoid , Bass viol 



Freddy Eichelberger , Harpsichord 

Works by M. Marais, D. Castello, F. Hognoni 



Pattern n° 19 - Construction dynamique de Pagencement 
dun tableau HTML 

Nous avons deja vu le problemede la generation dynamique d'une page HTM L, qui 
consiste a creer dynamiquement un contenu, ensuite plaque sur un fond HTML plus 
ou moins statique (voir Pattern n°16 - Generation de pages HTML dynamiques, 
page 518). 

Le pattern que nous allons voir maintenantva beaucoup plus loin : il permet de generer 
dynamiquement non seulement le contenu, mais aussi la disposition de ce contenu dans 
la page. 



Note 

L'idee de ce pattern m'est venue en lisant une intervention de J eni Tennison (tres active sur la mailing list XSLT 
de www.mulberrytech.com/xsl/xsl-listf). On pourra la retrouveren faisantune recherche de «The evaluate 
function » surle moteurde recherche de www.biglist.com/lists/xsl-listfarchives/eten restreignantla recherche 
aumoisde Janvier 2002. 
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Pour fixer les idees, et voir I'inteYet de la chose, imaginons une application Internet qui 
envoieau client (un navigateur) un tableau desynthesequelconque, commecelui montre 
en exemple figure 9-6. 



Figure 9-6 

Un tableau a 
plusieurs colonnes. 



fflFavons Hl sto,ique- | j^ 



Produit ISBN Prix | Titre | Auteur Interprete 


Livre 


i93jij 


6 


i/ingt tiLLi J e Ufrues 


luksVemss 




u- 


533791 


4.5 


I'mgefsieui aimait. 
tiop les chiffres 


Pierre 
Boileau 
Thomas 
Narcejac 




Compact 




21 


L.es Folies d'Espa^ne 


Mann 
Marais 


Jonathan Dun/ord, Basse 
de viole 
-i- l U, air l Li - 

Benjamin Peti'ot, Theorbe 
et guitate baroque 



Supposons maintenantquel'interfacedonnea utilisateur la possi bi lite de designer deux 
colonnes a permuter ; le probleme est de regenerer le meme contenu de tableau, avec la 
meme transformation XSLT, mais presents avec les deux colonnes permutees. 

Le probleme etant assez complexe a resoudre, et necessitant d'ailleurs I 'uti I isation 
d'extensionsau langageXSLT (qui vontrendrenon portable la solution proposee), il sera 
ici plus facile de proceder par etapes, afin de voir exactement ou se situent les problemes. 
N ous commencerons done par une version qui se contente de generer le tableau de facon 
statique, et qui ne permet done aucune permutation, sauf bien sflr en allant modifier le 
programme. 



Version statique 

Le tableau a generer est par exemple un extrait (limite aux CD etaux livres) d'inventaire 
d'un magasin, dontle stock est represents par lefichierbaseProduits.xmi : 



baseProduits.xml 
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<Livre ref="vernesl" 


NoISBN- 


"193335" 


gamme 


="roman' 


media=' 


papier"> 


<refOeuvres> 














<Ref valeur=' 


20000k 


lm"/> 










</refOeuvres> 














<Prix valeur="6" 


monnaie 


="EUR"/> 










<Prix valeur="5" 


monnaie 


="£"/> 










</Livre> 














<Livre ref="boileauna 


rcejac 


" NoISBN 


="533791" gamn 


e="roman 












medi 


a="papie 


r"> 


<refOeuvres> 














<Ref valeur=' 


liatlc 


bn"/> 










</refOeuvres> 














<Prix valeur="4.5 




ie="EUR" 


/> 








<Prix valeur="3" 


monnaie 


="£"/> 










</Livre> 














<Enregistrement ref=' 


marais 


" RefEdi 


gam 


LC00028C 
me="viol 


edegambe 


" media="CD" 


<refOeuvres> 














<Ref valeur=' 


marais 


folies'7 










<Ref valeur=' 


marais 


piecesl685"/> 








</refOeuvres> 














<Interpretes> 














<Interprete n 


om="Jonathan Dunford' 








<Role xml 


:lang= 


fr"> Bas 


se de 


viole </Role> 




<Role xml 


:lang= 


en"> Bas 


s Viol 


</Role> 






</Interprete> 














<Interprete n 


om="Sy 


via Abra 


mowicz 









<Role xml:lang="fr"> Basse de viole </Role> 
<Role xml :lang="en"> Bass Viol </Role> 
</Interprete> 
<Interprete nom="Benjamin Perrot"> 

<Role xml :lang="fr"> Theorbe et guitare baroque </Role> 
<Role xml :lang="en"> Theorbo and baroque guitar </Role> 
</Interprete> 
<Interprete nom="Stephane Fuget"> 

<Role xml :lang="fr"> Clavecin </Role> 
<Role xml :lang="en"> Harpsichord </Role> 
</Interprete> 
</Interpretes> 
<Titre xml :lang="f r"> 

Les Folies d'Espagne et pieces inedites 
</Titre> 

<Titre xml :lang="en"> Folies d'Espagne and unedited music </Titre> 
<Prix valeur="21" monnaie="EUR'7> 
<Prix valeur="13" monnaie="£"/> 
</Enregistrement> 
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<Materiel ref="HarKarl" refConstructeur="XL-FZ158BK" gamme="lecteurCD" 

marque="HarKar"> 
<refCaracteristiques> 

<Ref valeur="caracHarKarl'7> 
</refCaracteristiques> 
<Prix valeur="686" monnaie="EUR"/> 
<Prix valeur="400" monnaie="£'7> 
</Materiel> 

</LesProduits> 

<LesOeuvres> 

<0euvre ref="200001slm"> 

<Titre> Vingt mil le lieues sous les mers </Titre> 
<refAuteurs> 

<Ref valeur="JVernes"/> 
</refAuteurs> 
</0euvre> 
<0euvre ref="marais.fol ies"> 

<Titre> Les Folies d'Espagne </Titre> 
<refAuteurs> 

<Ref valeur="MMarais"/> 
</refAuteurs> 
</0euvre> 
<0euvre ref="marais.piecesl685"> 

<Titre> Pieces de viole en manuscrit </Titre> 
<refAuteurs> 

<Ref valeur="MMarais"/> 
</refAuteurs> 
</0euvre> 
<0euvre ref="l iatl c.bn"> 

<Titre> L'ingenieur aimait trop les chiffres </Titre> 
<refAuteurs> 

<Ref valeur="PBoileau"/> 
<Ref valeur="ThNarcejac"/> 
</refAuteurs> 
</0euvre> 
</LesOeuvres> 

<LesAuteurs> 

<Auteur ref="JVernes"> 

<Nom> Jules Vernes </Nom> 
</Auteur> 
<Auteur ref="MMarais"> 

<Nom> Marin Marais </Nom> 
</Auteur> 
<Auteur ref="PBoileau"> 

<Nom> Pierre Boileau </Nom> 
</Auteur> 
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<Auteur ref="ThNarcejac"> 

<Nom> Thomas Narcejac </Nom> 
</Auteur> 
</LesAuteurs> 

<LesGammes> 

... inutilise ici ... 
</LesGammes> 

<LesMarques> 

</LesMarques> 

<LesCaracteristiques> 

... inutilise ici ... 
</LesCaracteristiques> 

3aseProduits> 

Le programme XSLT pour obtenir le tableau statiquement ne pose aucune difficulte 
particuliere. II y a une regie par element d'inventaire (uvre ou Enegistrement), et 
dans chacunedeces deux regies, on construitunelignedu tableau avec la total ite des 
colonnes. Si une colonne est sans objet pour I 'element courant (par exemple un No 
ISBN pour un disque), on instancie une espace non secable, sinon on instancie la 
valeur concerned recuperet plus ou moins simplement dans le document XML, le 
plus complique etant I'instanciation des noms d'auteurs. S'il y a plusieursauteurs ou 
plusieurs interpretes, Ms sont tous copies dans la cellule courante du tableau ; par 
contre, s'il y a plusieurs ceuvres dans lememe I ivreou lememeenregistrement, seule 
la premiere est prise en compte. 

baseProduits.xsl 

xml version="1.0" encoding="IS0-8859-l" ?> 



rstylesheet 


xmlns:xsl="http://www 


.w3 


org/1999/XSL/T 


<xsl :templa 


e match="/"> 






<HEAD> 








<TITLE>Catalogue</TITLE> 






</HEAD> 








<B0DY> 








<xs 


:apply-templates/> 






</B0DY> 








</HTML> 








</xsl:templ 


te> 







<xsl : tempi ate match="l_esProduits"> 
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<table border="l"> 
<tr> 

<th>Produit</th> 
<th>ISBN</th> 
<th>Prix</th> 
<th>Titre</th> 
<th>Auteur</th> 
<th>Interprete</th> 
</tr> 

<xsl :apply-templates/> 
</table> 
</xsl :template> 

<xsl : tempi ate match="Livre"> 
<tr> 

<td>Livre</td> 

<td><xsl :value-of select="@NoISBN"/X/td> 

<td><xsl:value-of select="./Pr1x[8monna1e='EUR']/8valeur"/X/td> 

<td> 

<xsl :cal 1 -tempi ate name="instancier-titreOeuvre"> 
<xsl :with-param name="refOeuvre" 

select="./refOeuvres/Ref[l]/@valeur" /> 
</xsl:call -template) 
</td> 
<td> 

<xsl :call-template name="instancier-nomsAuteurs"> 
<xsl :with-param name="refOeuvre" 

select="./refOeuvres/Ref[l]/@valeur" /> 
</xsl:call -template) 
</td> 

<td><xsl:call -tempi ate name="instancier-nbsp"/X/td> 
</tr> 
</xsl :templ ate> 

<xsl :template match="Enregistrement"> 
<tr> 

<td>Disque Compact</td> 

<td><xsl:call -tempi ate name="instancier-nbsp"/X/td> 

<td><xsl:value-of select="./Pn'x[@monnaie='EUR']/@valeur"/X/td> 

<td> 

<xsl :call-template name="instancier-titreOeuvre"> 
<xsl :with-param name="refOeuvre" 

select="./refOeuvres/Ref[l]/@valeur" /> 
</xsl:call -template) 
</td> 
<td> 

<xsl :cal 1 -tempi ate name="instancier-nomsAuteurs"> 
<xsl :with-param name="refOeuvre" 

select="./refOeuvres/Ref[l]/@valeur" /> 
</xsl:call -template) 
</td> 
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<td> 

<xsl : call -template name="instancier-interpretes"/> 
</td> 
</tr> 
</xsl :template> 

<xsl :template match="text( )"/> 

<xsl :template name="instancier-titreOeuvre"> 

<xsl:param name="refOeuvre"/> 

<xsl :variable name="Oeuvre" 

select="/7Les0euvres/0euvre[@ref=$ref0euvre]"/> 

<xsl :value-of select="$0euvre/Titre'7> 
</xsl :template> 

<xsl :template name="instancier-nomsAuteurs"> 
<xsl:param name="refOeuvre"/> 
<xsl :variable name="Oeuvre" 

select="/7Les0euvres/0euvre[@ref=$ref0euvre]"/> 
<xsl :for-each select="$Oeuvre/refAuteurs/Ref "> 

<xsl :variable name="refAuteur" select="@valeur"/> 
<xsl : variable name="Auteur" 

select="//LesAuteurs/Auteur[@ref=$refAuteur]'7> 

<xsl :value-of select="$Auteur/Nom"/> 
<xsl:if test="position() != last( )"><br/X/xsl :if> 
</xsl:for-each> 
</xsl :template> 

<xsl :template name="instancier-interpretes"> 

<xsl :for-each select="Interpretes/Interprete"> 
<xsl :value-of select="@nom"/> 
<xsl:text>, </xsl :text> 

<xsl:value-of select="Role[@xml :1 ang = 'fr']'7> 
<xsl:if test="position() != lastO'Xbr/X/xsl :1f> 
</xsl:for-each> 
</xsl :template> 

<xsl : template name="instancier-nbsp"> 

<xsl :text disable-output-escaping="yes">&</xsl :text>nbsp; 
</xsl :template> 

</xsl:stylesheet> 

A rrive a ce stade, on voitdeja que cen'est pas simple depermuter deux colonnes : il faut 

intervenir dans I estrois regies aSSOCieesaUX elements Produits, L1vre et Enregistrement, 

et permuter (de la meme facon dans ces trois endroits) les lignes source X SLT representant 
unecolonne. 
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Version dynamique 

L'idee d'une generation dynamique, c'est toujours d'interpreter des donnees au lieu de 
lescabler dans le programme. Ici, nous allons done mettreen place un document XML 
qui va decrire la facon dont on veut que les colonnes apparaissent dans le fichier HTML 
genere.Voici une possibility parmi d'autres, qui montreun exempled'un tel fichier: 



Table, xml 










<?xml ve 


rsion="l 


0" encoding="UTF 


16" 




<table 1 


d="Livre. 


EtEnregistrement 






<col 


onne tit 
<Livre 
vale 


e="Produit"> 
r="Livre'7> 








<Enregistrement 








vale 


r="Compact D i s c " / > 




</cc 


lonne> 








<col 


onne tit 
<Livre 


e="Prix"> 








eval = 


"./Prix[@monnaie 


'EUR 


]/8valeur"/ 




<Enregistrement 








eval = 


"./Prix[@monnaie 


'EUR 


]/@valeur'7 


</cc 


lonne> 








<col 


onne tit 
<Livre 


e="ISBN"> 
"./@NoISBN"/> 








<Enregistrement 








call* 


"instancier-nbsp 


/> 




</cc 


lonne> 








<col 


onne tit 


e="Auteur"> 







< L i v r 



rsAutei 



param="./refOeuvres/Ref[l]/@vale 
<Enregistrement 

cal l="instancier-nomsAuteurs" 
param="./refOeuvres/Ref[l]/@valeL 
</colonne> 



<color 



; titre="Titre 



<Livre 

call="instancier-titreOeuvre" 
param="./refOeuvres/Ref[l]/@valei 

<Enregistrement 

call="instancier-titreOeuvre" 
param="./refOeuvres/Ref[l]/@valei 
</colonne> 
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<colonne titre="Interprete"> 
<Livre 

call="instancier-nbsp'7> 
<Enregistrement 

call="instancier-interpretes"/> 
</colonne> 
</table> 



Ce document decrit une table qui contiendra des livres et des enregistrements, donne 
I'ordre des colonnes, et decrit, pour chaque element <i_ivre> ou <Enregistrement> du 
document source principal, lafacon d'allery recuperer les donnees. 

Certainesdonnees, fournies pari 'attri but vaieur,sont a prendre telles quel les: parexem- 
ple, la colonne Produit contient Livre pour un <i_ivre>, ou compact Disc pour un 
<Enregistrement> : il n'y a done pas de donnees a aller chercher dans ce cas. 

D'autres donnees sont des expressions X Path a interpreter ; ce sont eel les qui sont four- 
nies par I 'attri but evai. A I'execution, il faudra done interpreter dynamiquement ces 
expressionsXPath, et e'est la qu'interviendra la fonction d'extension evaiuateo, dispo- 
nibleavec leprocesseur Saxon ouXalan. 

Enfin certaines donnees sont obtenues par un cheminement trop complique pour etre 
exprime directement par une expression XPath ; dans ce cas on donne le nom d'un 
modele nomme qu'i I faudra executer (attri but caii),et on lui transmeteventuellementun 
parametre (attri but param). Si I'attribut param est present, il contient une expression 
XPath qu'il faudra interpreter. 

Le fait d'avoir commence par la version statique permet d'anticiper les difficult.es 
d'acces aux donnees : en particulier, on sait que la recuperation des noms d'auteurs 
n'est pas simple, car il peuty en avoir plusieurs par ceuvre, cequi impliqueunebou- 
cle <xsi :for-each> (d'ou I'appel a un modele nomme). Notons en passant que 
I'appel d'un modele nomme dont lenom estcontenu dans une variable est interdi ten 
XSLT : la encore, il faudra faireappel a une extension, qui rend possible ['utilisation 
d'un descripteur de valeur differee pour I'attribut name de I 'instruction <xsi :caii- 

templateX 

Ceci etant, ce fichier de description doit permettre de changer I'ordre d'apparition des 
colonnes dans le tableau, tout simplement en permutant les deux elements correspon- 
dents. Ce n'est d'ailleurs pas la seule facon : on peut aussi laisser ce fichier intact et 
transmettre le nom et I'ordre des colonnes au programme d'interpretation, mais nous 
verronscettedeuxieme solution plus loin. 

II est clair que ce fichier apporte plus de souplesse que la simple permutation facile de 
colonnes: il est tres facile, par exemple, d'ajouter un nouvel element a prendre en 
comptedans I'inventaire, si toutefois une simple expression XPath peut en venir a bout. 
S'il faut un modele nomme, cela implique une modification du programme pour y ajouter 
ce modele nomme. 
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Le pattern consiste a mettre en place I'enchainement suivant, que I 'on va maintenant 
explicitersurun exemple. 

Etape 1 : traitement d'un element qui doit figurer dans le tableau. Par exemple, trai te- 
rn en t d'un element <uvre> du document source principal (baseProduits.xmi). Cet 
element est mis dans un node-set ei ementcourant ne contenant que cet element. 

Etape 2: constitution d'un node-set EiementsPiiotes contenant tous les elements 
<Livre> du document Tabi e.xmi . Ce node-set est appele EiementsPiiotes parce qu'il 
contient effectivement des elements, et que ces elements pilotent le processus de recupe- 
ration des donnees i nteressantes. Dans notre exemple, ce node-set contient tous les 
<Livre> du document Tabi e .xmi , et pour chacun d'eux on trouvesoitun attribut vaieur, 
soitun attribut evai, soitun attribut can, qu'il vafalloir interpreter. 

Etape 3 : constitution du texte de I'expression permettant I'acces a la donnee, et inter- 
pretation dynamique decetexted'expression. 

Etape 3A : cas del 'attribut vaieur, qui est le plus simple. Eneffet, il n'y arien departi- 
culier a faire dans ce cas, si ce n'est de prendre en compte la vaieur fournie. 

Etape 3B : cas de I 'attribut evai, qui est le plus typique. On recupere une chaine de 
caracteres, par exemple ./Prix[@monnaie='EUR']/@vaieur. Cette chaine de caracteres 
doit etre rapprochee de I 'element courant <i_ivre> contenu dans le node-set ei ement- 
courant. En effet, I'expression a interpreter est 

$E1 ementCourant/. /Prix[@monnaie=' EUR' ]/@valeur 

Le '/./' median amene une redondance, mais qui est inoffensive (et que I'on pourrait 
facilement supprimer). Le texte de cette expression resulte de la concatenation des trois 
chaines de caracteres : 

'$E1 ementCourant' 

'/' 

./Prix[@monnaie=' EUR'] /©vaieur 

Les deux premieres sont des chaines litterales, et la derniere est la vaieur de I'attribut 
evai del'element pilote courant, desortequel'appel a la fonction concato correspondant 
vas'ecrire: 

concatCSElementCouranf, '/', @eval) 

Eta I 'execution, cetappel vafournir I'expression : 

$E1 ementCourant/. /Prix[@monnaie=' EUR'] /©vaieur 

Dans cet exemple, n'oublions pas que ei ementCourant est un node-set ne contenant que 
le<Livre> du document principal en coursde traitement. Desorte que cette expression, 
si on I'interprete, donne la vaieur du prix en euros du <Livre> courant, etc'estbien cette 
vaieur qu'il fallait recuperer pour la placer dans une cellule de tableau. 
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devaluation se fait par appel d'une fonction d'extension, fournie par Saxon et Xalan. 
Avec Saxon, I 'appel prend la forme suivante : 



:at('$ElementCourant' , 



Etape3C : casdel'attribut can, avec presence d'un attributparam, parexemple: 



1 1 faut a nouveau rapprocher la chaine fournie par I 'attri but param de I 'element courant du 
document source principal ; on opere done la concatenation des trois chaines : 



./refOeuvres/Ref[l]/@valeur 

Les deux premieres sont des chaines litterales, et la derniere est la valeur de I 'attri but 
param de I 'element pi lote courant, de sorte que I 'appel a la fonction concat ( ) correspondant 
vas'ecrire: 

concatCSElementCourant', '/', @param) 

Etal'execution, apres evaluation par la fonction saxomevaiuateo, cet appel vafournir 
I 'expression : 

| $ElementCourant/./refOeuvres/Ref[l]/@valeur 

Dans cet exemple, n'oublionspasque Eiementcourant estun node-set ne contenant que 
le<uvre> du document principal en coursdetraitement. De sorte que cette expression, 
si on I'interprete, donne la valeur de la premiere reference d'eeuvredu <i_ivre> courant. 

Cette valeur va done jouer le role d'argument pour I'appel du modele nomme dont le 
nom est la valeur de I 'attri but cai 1 de I 'element pi I ote. 

Quant a I'appel proprement dit du modele nomme, il doit prendre une forme speciale, 
parce qu'en XSLT standard, un tel appel est impossible. En effet, le nom du modele a 
appeler n'est pas ici connu statiquement, chose qu'XSLT interdit. Pour pouvoir tout de 
memeappelerce modele, il faut done utiliser une forme ouun descri pteurde valeur dif- 
feree d'attribut est autorise, cequi constitue une extension au langage, fournie par Saxon 
dela maniere suivante: 

<xsl : call -tempi ate name="{$tname}" saxon:allow-avt="yes"> 

Onpeutmaintenantdonnerle programme d' interpretation dela specification de disposition 
du tableau. 

baseProduits.xsl 

|<?xml version="1.0" encoding="IS0-8859-l" ?> 
<xsl: stylesheet 
xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 
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Chapitre 9 

xm1ns:saxon="http://icl .com/saxon" 
extension-element-prefixes="saxon" 

<xs1:output method='html ' encoding=' ISO-8859-1' /> 

<xsl variable 

name="tablel_ivresEtEnregistrements" 

select="documentC 'Table.xml ' )/table[@id=' LivresEtEnregistrements' ]"/> 

<xsl variable 

name="racineDocument Principal" 
select='7"/> 

<xsl : tempi ate match="/"> 
<HTML> 

<HEAD> 

<TITLE>Catalogue</TITLE> 
</HEAD> 
<B0DY> 

<xsl :apply-templates/> 
</B0DY> 
</HTML> 
</xsl :template> 

<xsl :template match="LesProduits"> 
<table border="l" > 
<tr> 

<xsl:call -tempi ate name="instancier-titresColonnes"/> 
</tr> 

<xsl :apply-templates/> 
</table> 
</xsl :templ ate> 



Etape 1 

<xsl :template match="Livre"> 

<tr> 

<xsl :cal 1 -tempi ate name= 

</tr> 
</xsl :templ ate> 



Etape 1 
<xsl :template match="Enregistrement"> 
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<xsl : call -tempi ate name="instancier-colonnes'7> 
</tr> 
</xsl :template> 



<xsl :template match="text( )"/ 



Fin des regies 



<xsl : tempi ate name="instancier-titresColonnes"> 

<xsl :for-each select="$tableLivresEtEnregistrements/color 

<th><xsl :value-of select="@titre'7X/th> 
</xsl:for-each> 

</xsl :template> 



<xsl :template name="instancier-colonnes"> 



Comme ce modele est appele depuis une regie sans xsl :for-each, 
l'element courant est 1 'element traite par la regie, a savoir 
un <Livre> ou un <Enregistrement> 



variable 

iame="ElementsPilotes" 

;elect="saxon:evaluate( 
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J $ElementCourant est un <Livre> 

_ivre valeur="Livre"X/Livre> 

_ivre eval="./Prix[@monnaie='EUR']/@valeur"X/L- 

_ivre eval="./@NoISBN"X/Livre> 

_ivre call="instancier-nomsAuteurs" 

param="./refOeuvres/Ref[l]/@valeur"X/Livi 

_ivre call="instancier-titreOeuvre" 

param="./refOeuvres/Ref[l]/@valeur"X/Livi 



; oil SElementCourant est un <Enregistrement> 

<Enregistrement valeur="Compact Disc"X/Enregistrement> 

<Enregistrement eval=" ./Prix[@monnaie='EUR' ]/@valeur"> 

</Enregistrement> 

<Enregistrement call="instancier-nbsp"X/Enregistrement> 

<Enregistrement cal l="instancier-nomsAuteurs" 

param="./refOeuvres/Ref[l]/@valeur"> 
</Enregistrement> 

<Enregistrement cal l="instancier-titreOeuvre" 

param="./refOeuvres/Ref[l]/@valeur"> 
</Enregistrement> 

<Enregistrement cal l="instancier-interpretes"> 
</Enregistrement> 



<xsl :for-each select="$ElementsPilotes"> 
<td> 

<xsl :choose> 
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<xsl :when test="@valeur"> 

<xsl :value-of select="@val 
</xsl :when> 



<xsl :when test="@eval "> 

<xsl : value-of select="saxon:e\ 
concat( 'SElementCourant' , 



<xsl :when test="@cal1"> 

<xsl :choose> 

<xsl :when test="@para 
<xsl :cal 1 -tempi at 



<xsl :with-param 

name="refOeuvre" 
select="saxon:evaluate( 

concatt 'SElementCourant ' , 



</xsl :call -template> 




</xsl :when> 




<xsl :otherwise> 




<xsl :call-template 




name="{@call}" saxon:allc 


w-avt 


<xsl :with-param 




name="ElementCourant" 




select="$ElementCoura 


nt"/> 


</xsl : call -tempi ate> 




</xsl :otherwise> 
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</xsl:choose> 

</td> 
</xsl:for-each> 
</xsl :templ ate> 



<xsl :template name="instancier-titreOeuvre"> 
<xsl:param name="refOeuvre"/> 
<xsl:variable 

$racineDocumentPrincipal//Les0euvres/0euvre[@ref=$ref0euvre]'7> 
<xsl :value-of select="$0euvre/Titre'7> 
</xsl :template> 



<xsl :template name="instancier-nomsAuteurs"> 
<xsl:param name="refOeuvre"/> 

SracineDocumentPrincipal //LesOeuvres/Oeuvre[@ref=$ref0euvre]"/> 
<xsl :for-each select="$0euvre/refAuteurs/Ref > 

<xsl :variable name="refAuteur" select="@valeur"/> 
<xsl :variable 

select="//LesAuteurs/Auteur[@ref=$refAuteur]"/> 
<xsl :value-of select="$Auteur7Nom"/> 
<xsl:1f test="position() != last( )"><br/X/xsl :if> 
</xsl:for-each> 
</xsl :template> 



<! > 

<xsl :template name="instancier-interpretes"> 
<xsl rparam name="ElementCourant"/> 

<xsl :for-each select="$ElementCourant/Interpretes/Interprete"> 
<xsl :value-of select="@nom"/> 
<xsl:text>, </xsl:text> 

<xsl :value-of select="Role[@xml :lang = 'fr']"/> 
<xsl:if test="position() != last( )"><br/X/xsl :if> 
</xsl:for-each> 
</xsl :template> 
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|<xsl :text disable-output-escaping="yes">&</xsl :text>nbsp; 
</xsl:template> 

</xsl: stylesheet) 

U n element qu'il faut toujours prendre en compte, pour I'instanciation d'un model e, c'est 
que lecontexte devaluation ne change pas del 'appelant a I'appele : or, ici, certains des 

modeleS nommeS (instancier-nomsAuteurs, instancier-i nterpretes, par exemple) 

sont appeles a I'interieur de la boucle sur les elements pilotes (etape 3). Cette boucle 
change le contexte devaluation : en particulier le nceud courant est un element pilote, 

done un element du document XML Table. xml. Or le modele nomme instancier- 
nomsAuteurs, par exemple, evalue I 'expression XPath 

//LesOeuvres/Oeuvre[@ref=$refOeuvre] 

Si I 'on ne fait rien de particulier, cette expression sera done evaluee par rapport a un 
nceud contexte si tue dans le document Table. xml, cequi n'aevidemmentaucun sens. II 
est done necessaire de retrouver le document principal lors de devaluation de cette 
expression, cequi est rendu possible par la variable globale racineDocumentPrincipai. 

A I'execution, les colonnes du tableau s'affichent dans I'ordre ou el les apparaissent dans 
le document Tabi e.xmi (voir figure 9-7). 



Figure 9-7 

Un tableau dont les 
colonnes (ordreet 
contenu) sont 
species a part. 



| Fichier Edition Affichage Favoris Outils 



' @ (?) ffl SRechercher ±] Favoris g&Histarique 



Produit 


Prix ISBN Auteur 


Titre 


Interprete 


Livre 


6 


193335 


Jules 
Vemes 


Vmgtmillelieues 




Uvre 


4.5 


533791 


Piene 
Eoileau 
Thomas 


.'iiigfinieui' ainiait 

,!T;p hs cluffi:'&S 




Disc 


21 




Marin 
Maiais 


d'Espagne 


iDi rnfoid, 

.1 amoHirz, 

Theorbe et guitare 
baroque 
Stephane Fuget, 



II est vrai que la solution obtenue peut ne pas resoudre tout a fait le probleme pose : en 
effet, pui sque I 'uti I isateur peut dynamiquementdemander une permutation de I'ordre de 
presentation des colonnes, il faut pouvoir repercuter cette demande sur le document 
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Table. xmi, et permuter en consequence les deux elements correspondants. C'estevidem- 
ment trivial a real i ser en XSLT, mais peut-etren'est-ce pas la solution quel'on souhaite- 
rait. Une autre solution, plus dynamique, consisterait a indiquer au programme 
d' interpretation (baseProduits.xsi) I'ordre des colonnes souhaite, sous la forme d'un 
parametretransmislorsdel'appel : 

Ligne de commande (d'un seul tenant) 

Java -classpath "C:\Program Files\JavaSoft\SAXON\saxon. jar; " 
com. icl .saxon. Stylesheet -o baseProduits.html BaseProduits.xml BaseProduits.xsi 
ordreColonnes="Produit Prix Auteur Titre ISBN Interprete" 

Dans ce cas, le document Tabi e.xmi ne sert plus a determiner I'ordre des colonnes, mais 
seulement a specifier I'acces aux donnees. On pourrait aussi choisir une option mixte 
dans laquellece document XML donne I'ordre des colonnes par defaut, en I 'absence du 
parametreordreCoionnes lorsdu lancementdu processeur. 

Pourobtenir leresultatcherche, il n'y aassez peu de modifications a apporter, car le pat- 
tern reste essentiellement le meme; mais au lieu de boucler sur les elements pilotes 
(etape3), il faut boucler sur les elements fournis par le parametreordreCoionnes. 

C'estd'ailleurs une occasion d'utiliser encore une nouvelle extension, caronsaitqu'une 
boucle<xsi : for-each> est adaptee uniquement au parcours de node-sets ; orjustement, 
il existe une extension Saxon (ouXalan)qui transforme une suite de lexemes en un node- 
set d'elements dont les valeurs textuelles sont les lexemes fournis : il s'agit de la fonction 
saxon :tokenizeo, quel'on uti I i sera done a cette fin . 

baseProduits.xsi 

<?xml version="1.0" encoding="IS0-8859-l" ?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

xmlns:saxon="http://icl .com/saxon" 

extens ion -el ement-prefixes=" saxon" 

<xsl:output method='htmr encoding=' ISO-8859-1' /> 

<xsl :param 

name="ordreColonnes" 

select="'Produit Prix Auteur Titre ISBN Interprete "7> 

<!-- donne I'ordre par defaut des colonnes --> 

<xsl variable 

name="tablel_ivresEtEnregistrements" 

select="document( 'Tables.xml ' )/tabl e[@id= ' LivresEtEnregistrements ']"/> 

<xsl variable 

name="racineDocument Principal" 
select="/"/> 

<xsl :template match="/"> 



Patterns de transformation 



<HTML> 

<HEAD> 

<TITLE>Catalogue</TITLE> 
</HEAD> 
<B0DY> 

<xsl :apply-templates/> 
</B0DY> 
</HTML> 
</xsl :template> 

<xsl : template match="LesProduits"> 
<table border="l" > 
<tr> 

<xsl : call -tempi ate name="instancier-titresColonnes"/> 
</tr> 

<xsl :apply-templates/> 
</table> 
</xsl :template> 



Etape 1 

<xsl :template match="l_ivre"> 

<tr> 

<xsl :cal 1 -template name= 

</tr> 
</xsl :template> 



<xsl :template match="Enregistrement"> 

<tr> 

<xsl :call -template name="insta 

</tr> 
</xsl :template> 



<xsl template match="text()"; 
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<xsl :template name="instancier-titresColonnes"> 

<xsl :for-each select="saxon:tokenize( SordreColoi 

<th><xsl:value-of select=" . "/></th> 
</xsl:for-each> 

</xsl : tempi ate> 



"instancier-colonnes"> 



Comme ce modele est appele depuis une regie sans xsl :for-each, 
1 'element courant est 1 'element traite par la regie, a savoir 
un <Livre> ou un <Enregistrement> 

<xsl :variable name="ElementCourant" select="current( )"/> 
<xsl :variable name="ElementName" select="local -name( )"/> 



<xsl :for-each select="$l_esNomsDeColor 



<xsl variable 

name="NomDel_aColonneEnCours" 
select="."/> 

<xsl variable 

name="ElementPilote" 
select="saxon:evaluate( 
concatt 

'$tableLivresEtEnregistrements/colonne[ 
@titre="', 

$NomDeLaCol onneEnCours , ' &#34 ; ]/ ' , 
SElementName 



I :for-each select="$ElementPilote"> 
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<xsl :when test="@valeur"> 

<xsl :value-of select="@val 
</xsl :when> 



Etape 3B 

<xsl :when test="@eval "> 

<xsl:value-of select="saxon:e\ 
concat( 'SElementCourant' , 

)"/> 
</xsl:when> 



<xsl :when test="@call": 



<xsl :choose> 




<xs 


:when test="@param"> 




<xsl:cal 


-template 




name 


="{@cal 1 }" saxon:allow- 




<xsl 


with-param 
ame="refOeuvre" 
elect="saxon:evaluate( 
concatt '$ElementCoura 
"/> 




</xsl :ca 


1 -tempi ate> 


</x 


1 :when> 




<xs 


:otherwi 


e> 




<xsl:cal 


-template 




name 
<xsl 


="{@cal 1 }" saxon:allow- 

ame="ElementCourant" 
elect="$ElementCourant 




</xsl :ca 


1 -tempi ate> 


</x 


1 :otherw 


se> 


</xsl :choose> 




1 :when> 







</xsl :choose> 



</xsl :for-each> 
;1 :template> 
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<xsl :template name="instancier-titreOeuvre"> 
<xsl:param name="ref0euvre'7> 
<xsl: variable 

SracineDocumentPrincipal //LesOeuvr 
<xsl :value-of select="$0euvre/Titre'7> 
</xsl :template> 



s/0euvre[@ref=$ref0euvre]'7> 



<! > 

<xsl :template name="instancier-nomsAuteurs" 
<xsl:param name="ref0euvre'7> 



<xsl:< 



iable 



$racineDocumentPrincipal//Les0euvres/0euvre[@ref=$ref0euvre]'7> 
<xsl :for-each select="$Oeuvre/refAuteurs/Ref "> 

<xsl :variable name="refAuteur" select="@valeur"/> 
<xsl : variable 

select="//LesAuteurs/Auteur[@ref=$refAuteur]V> 
<xsl :value-of select="$Auteur/Nom'7> 
<xsl:if test="position() != last( )"><br/X/xsl :if> 



</X5 



:for- 



ach> 



</xsl : tempi ate> 



<!-- 



<xsl :template name="instancier-interpretes"> 
<xsl :param name="ElementCourant"/> 
<xsl :for-each select="$ El ementCourant/Interpretes/ Interpreted 

<xsl :value-of select="@nom"/> 

<xsl:text>, </xsl:text> 

<xsl :value-of select="Role[@xml :lang = 'fr']"/> 

<xsl:if test="position() != last( )"><br/X/xsl :if> 



</X5 



:for- 



ach> 



</xsl : tempi ate> 



<xsl :template name="instancier 
<xsl:text disable-output-e 
</xsl :template> 



:aping="yes">&</xsl :text>nbsp; 



I Patterns de transformation 



L'etape 2 a disparu, puisque cette etape consistait dans la version precedente a rassem- 
bler les elements pilotes dans un node-set, chaque element pilote correspondant a une 
colonne. Ici, e'est inutile, puisque la liste des colonnes est deja connue au travers de la 
variable ordreCoionnes. L'etape 3 se transpose done ici en un parcours du node-set 
LesNomsDeCoionnes construit a partir de cette liste, le node-set en question etant par 
contre constitue de nceuds completement deconnectes du document Table. xmi. Done 
pour avoir un element pilote a partir du NomDeLaCoionneEnCours, il faut effectuer une 
recherche de cet element pilote dans le document Table. xmi connaissant le nom de la 
colonne courante, etl'elementatraiter (<Livre> ou <Enregistrement>). Cette recherche 
est eff ectuee par I 'expression XPath initial isant la variable EiementPiiote. 

Cette expression X Path est construite a partir des donnees suivantes : 

• $NomDeLaCoionneEnCours : une chaine de caracteres donnant le nom de la colonne 
(parexemple 'Prix') ; 

• $ei ementName : une chaine de caracteres donnant le nom de I'element (du document 
principal) en coursdetraitement (parexemple 'Livre"). 

Avec ces donnees, il faut construi re I 'expression suivante: 

$tableLivresEtEnregistrements/colonne[@titre="Pr7x"]//.7vre 

Dans cette expression, tout est constant, sauf les deux noms indiques en gras, qui sont des 
valeurs de variables. On peut done construi re une chaine de caracteres contenant 
I 'expression ci-dessus, par concatenation deconstantes I itterales etde valeurs de varia- 
bles, maisil resteleproblemedesguillemets. On utilise ici des entites caracteres pour les 
representor (&#34 ; ), car sous forme litterale, ils entreraient en conflit avec ceux utilises 
pour delimiter I'attribut select contenant I 'expression aevaluer, ou avec les delimiteurs 
de chaines litterales de la fonction concato. 

Unefois I 'expression construite, il n'y a plus qu'a I'evaluer, cequi sefaitcommed'habi- 
tudeparappel a la fonction saxon:evaluate(). 

Le resultat de cette evaluation est un node-set ne contenant qu'un seul element : un 
element pilote du documentTabie.xmi. Cet element pilote doitmaintenant devenir le 
noeud courant, pour nous ramener a la version precedente du programme, ou il y avait 
unebouclesur un node-set d'elements pilotes. C'estla raison dela presence du for- 
each suivant, qui ne sert pas a effectuer une boucle (puisque de toute facon, on est 
certain que le node-set a parcourir ne comporte qu'un seul element), mais sert uni- 
quement a changer de contexte devaluation (voir la section Autre Se'mantique, 
page 140). 

Unefois que le noeud courant est un element pilote, lerestedu programme est essenti el - 
lement identique a celui de la version precedente, et le resultat obtenu est montre a la 
figure 9-8. 
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Figure 9-8 

Permutation des 
colonnes speafiee 
lorsdel'appel du 
programme. 



B - ■ 

S- ; '_ | hi- I h I uhn t-ii pdn j-j - |<SearchwiihG _-j . _ - 
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Auteur 
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Inter; rete 
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193335 
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4.5 


Pierce 
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L'ingenieur aimait 
.top let": d'liffres 


333791 




Disc 


21 


Marin 
Marais 


Les Folies 
d'Espagne 




ionathan Dunfoid, Basse 
Sylvia Abfifflicraics, Basse 

et guitaie baroque 
Stephane Fuget, Clavecin 
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Ce pattern va donner un exemple de generation de documents multiples, pour lequel le 
resultat obtenu ne sera done pas un seul fichier, mais plusieurs, ce qui permettra par 
exemple a une application de produire tout un ensemble de pages HTML liees les unes 
aux autres par des liens actifs. 

Nous allons prendre I 'exemple d'un document XML representant un support de cours, 
divise en pages, commececi : 



XMLXSL.xml 

<?xml vers 



2ncoding="IS0-8859-l" ?> 



"XML.O" nextPage="XML.l"> 

tation>Comprendre XML et XSL</titrePresentatior 



<pageDeTitre ■ 
<titrePre: 
<credit> 

<groupeAuteurs> 

<auteur>Philippe Drix</auteur: 
<societe>OBJECTIVA</societe> 
</groupeAuteurs> 
</credit> 
</pageDeTitre> 



<pageStandard id="XML.l" previousPage="XML.O" nextPage="Table" 
<t1trel id="XML.l.Deroulement">Deroulement du Cours</titre 
<blocl> 
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<item> 

Le cours XML se deroule de 9h30 a 12h30 et de 14h a 17h30. 

</item> 

<bloc2> 

Pauses-cafe a llh et 16h. 
</item> 
<item> 

Discussions libres pendant le dejeuner et apres 17h30. 
</item> 
</bloc2> 
</blocl> 
<blocl> 
<item> 

Le dernier jour, foire aux questions de 16h30 a 17h30. 
</item> 
</blocl> 
</pageStandard> 

<plan id="Table" previousPage="XML.l" nextPage="XML.2"/> 

<pageStandard id="XML.2" previousPage="Table"> 

<titrel id="XML.2general"> XML - Generality </titrel> 
<blocl> 
<item> 

XML est un langage de balisage de textes. 
</item> 
</blocl> 

<titre2 id="XML.2.bal isage"> Balisage </titre2> 
<blocl> 
<item> 

Le principe d'un langage de balisage de textes existe depuis 
fort longtemps, 

avant meme l'invention de 1 ' informatique. 
</item> 
<bloc2> 
<item> 

en imprimerie, le texte de l'epreuve est balisee de 
"corrections" a effectuer (balises textuelles), 
</item> 

et les relectures a voix haute, chez les typographes , 

se font agrementees de balises vocales codifiees, avec tout un 

argot de metier assez savoureux (trouve dans "Petite Histoire 

des signes de corrections typographiques" , par Jacques Andre, 

in Cahier GUTemberg No 31, Decembre 1998) : 

</item> 
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</item> 

le metro <texteImportant>ouvre</texteImportant> invente 
par Bienvenue <texteImportant>cap couilles clame suce ferme 
</texteImportant> 
</item> 
</bloc3> 
</bloc2> 
</blocl> 
<blocl> 

Avec 1 'invention de 1 'informatique, les techniques de balisages 
se sont appliquees a la commande des Linotypes par bandes 
perforees, ou le texte a composer etait parseme de commandes 
destinees a la manoeuvre de la Lynotype elle meme (passer en gras, 
changer de corps, faire un retrait, etc.). 
</item> 
</blocl> 
</pageStandard> 

</presentation> 

Le but est done d'obtenir une serie de pages HTM L , une par <pagestandard>, <pageDe- 
Titre>, ou <pian> du document XML. Le nom de chaque fichier resultat sera forme 

d'apreS I'attribut id de Chaque <pageStandard>, <pageDeTitre>, OU <plan>, auquel Oil 

ajoutera I e suffix e '.html ■. 

Done dans le notre exemple, on obtiendra au final les fichiers XML.o.htmi, XML.i.htmi, 
tabie.htmi, et xml. 2. html (voir figures 9-9 a 9-12). 



Figure 9-9 

Premiere page. 



J Fichier Edition 



Comprendre XML et XSL 

Philippe Drix 
OBJECTTVA 

bjertiva Comprendre XML et XSL 



_^ 
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Figure 9-10 

Deuxiemepage. 



Deroulement du Cours 



3 Le couts XML se detoule de 9h30 a 1 2h30 rt de 1 4h a 1 7h30 
o Pauses-cafe a llhetlSh. 

?s : : 1 i I'ltli 



.Led ,i , 1 _ I i li 

Ph. Dm - Objectiva Comprendre XML et XSL 



Deroulement du Cours 
XML - Generalites 



Balisaae 



' orapiem M el 31 



Le cceur du programme est constitue d'un modele nomme qui instancie les pages HTML 
suivant un format pre-determine : en-tete, corps de page, pied de page. L'en tete est en 
fait une barre de navigation permettant de passer de page en page en avant ou en arriere, 
ou d'aller directement a la table des matieres : 



I :template nan 






"-page") 



;v"/> 



;1 :document href="{$fileName}"> 
<xsl :call -template name="instancier-entete") 
<xsl :with-param name="next" select="conc 
<xsl :with-param name="prev" select="conc 
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Figure 9-12 

Troisiemepage. 
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GUTembergHo 31, Decembre 1998T|: 
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„, 
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4 





</X5 



I -tempi ate> 



<TABLE width="100%" height="90%" B0RDER="0" CELLSPACING="10"> 
<TR valign="top"XTD> 

<xsl :apply-templates/> 
</TDX/TR> 
</TABLE> 



7> 



L'instruction <xsi : document href=" . . . ">, uti I i see ci-dessus, permet de diriger la 
serialisation deson model ede transformation vers un fichier dont I'URI estfourni par 
I'attribut href. 
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Chapitre 9 

Cette instruction n'est pas une instruction du langage XSLT 1.0, qui ne fournit aucun 
moyen standard decreer plusieurs fichiers resultats. II est done necessaire, ici, d'utiliser 
une extension, qui se trouve disponible par exemple dans Xalan (sous une forme tres 
differente de celle qui est montree ci-dessus). 

Longtemps die a ete aussi proposee par le processeur Saxon (mais sous une forme lege- 
rement differente de la version ci-dessus). Puis le Working Draft 1.1 est paru, et a pro- 
pose une evolution permettant justement la creation de plusieurs fichiers resultat, sous la 
forme montree ci-dessus. Michael Kay a alors implements la nouvelle forme proposee, 
cequi faitqu'il estpossiblede I'utiliser commesi e'etait une instruction normale(etnon 
pas une extension), a condition d'indiquer au moins 1.1 comme numero de version de 
langage XSLT. 

Signalons pour terminer que I 'extension proposee par Xalan peut etre plus pratique dans 
certains cas; die se decompose en trois fonctions: xaian:open(), xaian:write(), et 
xaian:cioseo. Cela permet de constituer un fichier petit a petit, alors qu'avec I 'instruc- 
tion xsi :document, il faut le constituer d'un seul coup en un seul bloc. Si done plusieurs 
instructions xsi :document sont executees avec le meme nom de fichier, le fichier est 
ouvert et referme a chaque fois, et chaque ecriture ecrase la precedente. Au contraire, 
avec I 'extension proposee par Xalan, il est faci I edecreerun fichier par aj outs successifs, 
par exemple pour conserver une trace de I'execution d'un programme XSLT, lorsqu'on 
recherche la cause d'une erreur coriace a detecter. 
Voici maintenantle programme, qui nemetrien enceuvrequi n'aitdejaetevu. 



<?xml version="1.0" encoding="UTF-16"?> 

<xsl: stylesheet xmlns :xsl="http: //www. w3.org/1999/XSL/Transforir 
version="l.l"> <!-- compatibility" Saxon 6.5 --> 

<xsl:output method='htmr encodings' ISO-8859-1' /> 



<xsl : tempi ate match="pageDeTitre"> 

<xsl :call -template name="instancier-page"> 

<xsl :with-param name="fileName" select="concat( @id, 
<xsl :with-param name="next" select="@nextPage" /> 
</xsl :call -template> 
</xsl :template> 

<xsl :template match="titrePresentation"> 

<H1 align="center"Xxsl:value-of select=" . '7X/H1> 
</xsl :template> 

<xsl :template match="auteur"> 

<H2 align="center"Xxsl:value-of select=" . '7></H2> 
</xsl :template> 
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<xsl :template match="societe"> 

<H2 align="center"Xxsl:value-of select=" . "/X/H2> 
</xsl :template> 



<xsl :template match="pageStandard"> 

<xsl :cal 1 -tempi ate name="instancier-page"> 

<xsl :with-param name="fileName" select="concat( @id, '.html' ) 
<xsl :with-param name="prev" select="@previousPage" /> 
<xsl :with-param name="next" select="@nextPage" /> 
</xsl: call -tempi ate> 
</xsl :template> 

<xsl : tempi ate match="titrel"> 

<H1 align="left"Xxsl:value-of select=" . "/X/H1> 
</xsl :templ ate> 

<xsl :template match="titre2"> 

<H2 align="left"Xxsl:value-of select=" . "/></H2> 
</xsl :template> 

<xsl :template match="blocl"> 

<UL TYPE="SQUARE"Xxsl:apply-templates/X/UL> 
</xsl :template> 

<xsl :template match="item"> 

<LIXxsl :apply-templates/X/LI> 
</xsl :templ ate> 

<xsl :template match="bloc2"> 

<UL TYPE="CIRCLE"Xxsl :apply-templ ates/X/UL> 
</xsl :templ ate> 

<xsl :template match="bloc3"> 

<UL TYPE="DISC"Xxsl :apply-templates/X/UL> 
</xsl :template> 

<xsl :template match="texteImportant"> 

<BXxsl :apply-templates/X/B> 
</xsl :templ ate> 



;l:template match="pl an"> 
<xsl :call-template name="instancier-pl an"> 

<xsl :with-param name="fileName" select="concat( @id, '.html' 
<xsl :with-param name="prev" select="@previousPage" /> 
<xsl :with-param name="next" se1ect="@nextPage" /> 
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</xsl : call -tempi ate> 
si :template> 



<xsl :templ ate match="titrel" mode="plan"> 

<H1 align="left"> 

<A HREF="{concat(parent::*/@id, '.html')}" 

<xsl:value-of select="."/> 

</A> 

</Hl> 
</xsl :template> 

<xsl :template match="titre2" mode="plan"> 

<H2 align="left"> 

<A HREF="{concat(parent::*/@id, '.html')}" 

<xsl:value-of select="."/> 

</A> 

</H2> 
</xsl :template> 



<xsl : tempi ate match="text() n mode="plai 



"/> 



<xsl :template name="instancier-page"> 



<xsl:param 


name="fileName"/> 




<xsl :param 


name="next"/> 




<xsl :param 


name="prev"/> 




<xsl :document href="{$fileNam 


e}"> 


<HTML> 






<HEAD> 






<TITLE>Cours XML</TITLE> 


</HEAD> 






<B0DY> 






<xsl:ca 


11 -tempi ate name=' 


instanci 


<xs 


1 :with-param name= 


•next" s 


<xs 


l:with-param name= 


'prev" s 


</xsl:C 


all -tempi ate> 





at( $next 


'.html' 


" /> 


at( $prev 


'.html' 


" /> 



<TABLE width="100r hei ght="90%" B0RDER="0" CELLSPACING="10"; 
<TR valign="top"XTD> 

<xsl :apply-templates/> 
</TDX/TR> 
</TABLE> 



<xsl 



:all -tempi ate name="instancier-piedDePage"/> 
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</xsl :document> 
</xsl :template> 






<TABLE valign="top" width="100%" height="2%" 



gn="left"> 

! age precedente</A> 



<TR> 

<TD width="33%' 
<A HREF="($pre» 
</TD> 

<TD width="34%" align="center"> 
<A HREF="Table.html">Table</A> 
</TD> 

<TD width="33r align="right"> 
<A HREF="{$next}">Page suivante</A> 
</TD> 
</TR> 
</TABLE> 
</xsl :template> 



="0" CELLSPACING="0" 
BGCOL0R="#FFFF99"> 






/"/> 



<TABLE valign="top" width="100%" height="2%" B0RDER="0" CELLSPAC I NG="0" 

BGC0L0R="#FFFF99"> 

<TR> 

<TD width="33%" al ign="left">Ph. Drix - Objectiva</TD> 

<TD width="34r al ign="center">Comprendre XML et XSL</TD> 

<TD w1dth="33*" al ign="right"> 

<xsl:number count="pageDeTitre | pageStandard | plan" level="any"/> 

</TD> 

</TR> 
</TABLE> 
</xsl :templ ate> 
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<xsl:param name="fileName"/> 










<xsl:param name="next"/> 










<xsl:param name="prev"/> 










<xsl :document href="{$fileName}"> 










<HTML> 










<HEAD> 










<TITLE>Cours XML</TITLE> 










</HEAD> 










<B0DY> 










<xsl : call -tempi ate name="instanc 


ier-entete' 


> 






<xsl :with-param name="next" 


select="con 


cat( $next 


'.html' 


" /> 


<xsl :with-param name="prev" 


select="con 


cat( $prev 


'.html' 


" /> 


</xsl: call -tempi ate> 











<TABLE width="100r hei ght="90%" B0RDER="0" CELLSPACING="10"; 
<TR valign="top"XTD> 

<xsl :apply-templates select="//pageStandard" mode="plan"/ 
</TDX/TR> 
</TABLE> 

<xsl :call-template name="instancier-piedDePage"/> 

</B0DY> 
</HTML> 
</xsl :document> 

;1 :template> 



</xsl:stylesheet> 

Le dernier fichier obtenu, par exemple, estcelui-ci : 

XML. 2 .html 

<HTML> 
<HEAD> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<TITLE>Cours XML</TITLE> 
</HEAD> 
<B0DY> 

<TABLE valign="top" width="100r height="2%" BORDER="0" CELLSPACI NG="0" 
BGC0L0R="#FFFF99"> 
<TR> 

<TD width="33r al ign="left"XA HREF="Table.html "> 
Page pr&ea cute ;cé den te</AX/TD> 

<TD width="34r al ign="center"XA HREF="Table.html ">Table</AX/TD> 
<TD width="33r al ign="right"XA HREF=" .html ">Page suivante</A> 
</TD> 
</TR> 
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</TABLE> 

<TABLE width="100r height="90r B0RDER="0" CELLSPACING="10"> 
<TR valign="top"> 
<TD> 

<H1 align="left"> XML - Généralité 
<UL TYPE="SQUARE"> 
<LI> 

XML est un langage de balisage de textes. 



</UL> 

<H2 align="left"> Balisage </H2> 
<UL TYPE="SQUARE"> 
<LI> 

Le principe d'un langage de balisage de textes 
existe depuis fort longtemps, 
avant même 1 'invention de 1 'informatique. 
</LI> 

<UL TYPE="CIRCLE"> 
<LI> 

en imprimerie, le texte de l'épreuve est 
bal isée de 

"corrections" à effectuer (balises textuel les) , 
</LI> 
<LI> 

et les relectures à voix haute, chez les 
typographes, 

se font agrémentées de balises vocales 
codifiées, avec tout un 

argot de métier assez savoureux (trouvé 
dans "Petite Histoire 

des signes de corrections typographiques" , par Jacques 
André , in 

Cahier GUTemberg No 31, Décembre 1998) : 
</LI> 

<UL TYPE="DISC"> 
<LI> 



</LI> 

<LI> 

le métro <B>ouvre</B> inventé 
par Bienven&uuml ;e <B>cap couilles clame suce ferme 
</B> 
</LI> 
</UL> 
</UL> 
</UL> 

<UL TYPE="SQUARE"> 
<LI> 
Avec 1 'invention de 1' informatique, les techniques de 
balisages 
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se sont appliquées à la commande des 
Linotypes par bandes 

perforées, où le texte à composer 
était parsemé de commandes 
destinées à la manoeuvre de la Lynotype 
elle même (passer en gras, 
changer de corps, faire un retrait, etc.). 
</LI> 
</UL> 
</TD> 
</TR> 
</TABLE> 

<TABLE valign="top" width="100%" height="2%" B0RDER="0" 
CELLSPACING="0" BGC0L0R="#FFFF99"> 
<TR> 

<TD width="33r al ign="left">Ph. Drix - Objectiva</TD> 
<TD width="34r al ign="center">Comprendre XML et XSL</TD> 
<TD width="33r al ign="right">4</TD> 
</TR> 
</TABLE> 
</B0DY> 
</HTML> 

II peut etre aussi interessant de voir le fichier Tabie.htmi, pour le comparer aux regie: 
qui I'ontcree. 

Tabie.htmi 

<HTML> 
<HEAD> 

<meta http-equi v="Content-Type" content="text/html ; charset=IS0-8859-l"> 

<TITLE>Cours XML</TITLE> 
</HEAD> 
<B0DY> 

<TABLE valign="top" width="100r height="2%" BORDER="0" CELLSPACI NG="0" 
BGC0L0R="#FFFF99"> 
<TR> 

<TD width="33r al ign="left"XA HREF="XML. 1 . html "> 
Page pr&ea cute ;cé den te</AX/TD> 

<TD width="34%" al ign="center"XA HREF="Table.html ">Table</A> 
</TD> 

<TD width="33r al ign="right"XA HREF="XML. 2 . html "> 
Page suivante</AX/TD> 
</TR> 
</TABLE> 

<TABLE width="100%" hei ght="90%" BORDER="0" CELLSPACING="10"> 
<TR valign="top"> 
<TD> 

<H1 align="left"XA HREF="XML.l.htral ">Déroulement du 
Cours</AX/Hl> 
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<H1 align="left"XA HREF="XML. 2 . html "> 
XML - Généralités </AX/Hl> 
<H2 align="left"XA HREF="XML. 2 . html "> Balisage </AX/H2> 
</TD> 
</TR> 
</TABLE> 

<TABLE valign="top" width="100r hei ght="2%" B0RDER="0" CELLSPACING^" 
BGC0L0R="#FFFF99"> 
<TR> 

<TD w1dth="33«" 
<TD width = "34r 
<TD width="33%" 
</TR> 
</TABLE> 



"left">Ph. Drix - Objectiva</TD> 
"center">Comprendre XML et XSL</TD> 
"right">3</TD> 
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Je presente ici une realisation reel I e, celle qui a permis la production technique de ce 
livre. J'avais commence, auparavant, la redaction d'un support de cours de formation 
XML etXSLT pour ma societe. Ce support etait lui-memeau format XM L, carl'un des 
objectifs etait de pouvoir realiser cette source sous differents formats, notamment un for- 
mat imprimablede hautequalite, et un format video-projetable. Leformatimprimablede 
haute qualite etait produit par une transformation XSLT donnant un source Latex (lui- 
meme a compiler pour produi re un fichier imprimable), etle format video-projetable par 
une autre transformation XSLT donnant du HTML. 

Note 

A I'epoque, la solution passant par du XSL-FO donnant du PDF a I'arrivee n'etait pas envisageable, car il n'y 
avait pas encore de processeurs FO disponibles, alors que les compilateurs Latex existent depuis de tres 
nombreuses annees. 

Puis I'idee m'est venue que ce document pourrait faire I'objet d'un livre, et j'ai com- 
mence a reprendre la redaction en consequence. Mais j'ai conserve le format source 
XML, afin de rester independant des technologies proprietaires, quelles qu'elles soient. 
Mon idee etait de peaufiner la transformation XSLT produisant du Latex, car il reste 
effectivement tres difficile de surpasser le resultat d'une compilation Latex, en ce qui 
concerne I 'aspect prof essionnel etesthetique del 'impression finale. 
Mais, apres avoir finalement signe un contrat d'edition avec la societe Eyrolles, il a 
fallu s'adapter a une chainede production partantd'un fichier source au format M icro- 
softWord : I'auteur est en effet cense fournir au final un document Word, stylise sui- 
vant une feuille de style fournie par Eyrolles. Ce document Word est le point de depart 
de la chainede production : il est sauvegardeau format RTF (le format texte capable de 
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sauvegarder sans perte de styles le contenu d'un document Word), puis repris sous 
F rameM aker avec uncertain nombrede macros permettantd'automatiserau maximum 
la miseen page. 

Partantd'undocumentXML, il n'y avaitque deux solutions pour fournirunfichier Word 
(ou RTF, cequi revientau meme) : 

• soitreprendrealamain la source XM L, I 'injecter petit a petit par copier-col ler dans un 
document Word, et appliquer au fur et a mesure les styles adequats ; 

• soit tenter d'obtenir automatiquement un fichier RTF correctement stylise a parti r de la 
sourceXML. 

La premiere solution demandeun travail long, fastidieux, etsansinteret. 

La deuxieme solution consiste a ecrire unefeuille de styleXSLT qui produisedu RTF a 
partir d'un document XML exprimant la structure et la semantiqued'un texte; mais la 
difficult^ essentielle, en tout cas pour moi, est la meconnaissance du format RTF lui- 
meme. 

Etantdonne les delais impartis, il m'etait impossible de me mettre a apprendre RTF ; je 
me suis alors rabattu sur une solution de fortune, mais qui s'est revelee finalement tres 
fiable et assez simple a mettre en ceuvre. J 'ai redige sous Word un texte d'une page ou 
deux, comportanttous les styles possiblesfournis par Eyrolles, texte que j'ai sauvegarde 
au format RTF. II m'aensuitesuffitdereperer les sequences RTF propresachaquestyle 
Word, et deles injecter dans chacunedes regies XSLT correspondantes. J'ai ainsi obtenu 
a peu de frais un generateur RTF, non universel, il est vrai, puisqu'entierement lie a la 
DTD adoptee pour le document X M L, mais capable de transformer toute instance XML 
decetteDTD en un fichier RTF ayant I 'aspect attendu lorsqu'on I'ouvre sous Word. 

C'estcette solution que j'ai done retenuepour la production finale du document RTF a 
fournira I'editeur. 



Structure du document source XML 

La structure du document XM L (ou DTD) a ete determined avant d'avoir a resoudre le 
probleme de la transformation en RTF. Cette DTD a largementete influenced par deux 
idees directrices : d'une part eviter les structures fortement hierarchiques, et d'autre part 
faciliter la transformation XSLT produisant du HTM L et du Latex, puisque e'etait au 
depart les deux langages-cibles envisages. 

La premiere contrainte etait motivee par la volonte de ne pas etre tributaire d'un editeur 
XML dedie, maisau contrai re depouvoir uti I iserun editeur detextes general iste, comme 
BB Edit sous MacOS, UltraEdit sous Windows, ou XEmacs sous Unix ou Windows. Or 
une DTD comme eel ledeDocBook, par exemple (voir Exemple, page 385), est extreme- 
ment penible a utiliser sans editeur XML specialise, a cause de la grande distance qui 
peutseparer une balise ouvrante de la balisefermantecorrespondante, etdu degreeleve 
d'imbrication des elements les uns dans les autres. Cela rend les modifications de 
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structure du document (par exemplepermuter deux sections, passer une section deniveau 
2 en niveau 3, ou I'inverse, etc.) inextricables a realiser sans un outil capable de manipuler 
global ementun element ettoutesa descendance. 

La deuxiemecontraintedemandea cequegrosso-modo, chaque baliseXM L utili see ait 
son equivalent en Latex et en HTML, c'est-a-dire qu'il n'y ait pas de fosse structurel 
entrele document source XM L et les documents resultats en HTML ou Latex. En fait il 
se trouve que Latex et HTM L sont deux langages de balises qui peuvent etre assez voi- 
sins structurel I ement, dans la mesure ou le principal, c'est le texte au kilometre (avec 
eventuellement un regroupement de phrases par paragraphe), parseme de balises indi- 
quant un titre de section niveau 1, 2, 3, etc. 

Or, il se trouve que RTF estlui aussi un langagede balises assez peu tourneversl'imbri- 
cation des structures mises en oeuvre. 

Nousavons done conserve a peu preslaDTD d'origine, en I'augmentantd'elementssup- 
plementaires provenant de la description des styles Word fournis par les editions Eyrol- 
les. Cette DTD, conformement aux deux contraintes indiquees ci-dessus, evite au 
maximum toute imbrication structurelle d'elements de type « bloc de texte » ; les seuls 
blocs structurants sont les paragraphes, les remarques, les listings de di verses sortes, les 
figures, les listes et les tableaux, mais ces elements sont uniquement juxtaposables (pas 
d'imbrication possible). 

Bien stir, des elements peuvent apparaitre dans un paragraphe, par exemple, (pour mar- 
quer un fragment de code dans du texte courant, ou pour indiquer des mots importants, 
ou des renvois vers d'autres parties du document, etc.), mais ces elements ne sont pas des 
blocs en cesensqu'ilsn'ontaucun enfant direct. 

Par exemple, le texte XM L aux environs de la section Instruction xsl: import, page 381 
est balise ainsi : 



<titre2 id="include. titre. 10. Decoupe" indexWords="l,2">Instructior 



<titre3 id="i mportSyntaxe.titre.il. Decoupe">Syntaxe</titre3> 



<titreCode>xsl :import</titreCode> 
<listingAvecTitreX![CDATA[<xsl: import 

href ="..." 
/>]]></! istingAvecTitre> 
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<paragraphe>L'attribut href <tresImportant> ne doit pas </tresImportant> etre un 

descripteur de valeur differee. 
</paragraphe> 

<paragraphe>L'instruction <codeDansTexte avant=" " apres=" ">xsl:import 
</codeDansTexte> doit apparaitre comme instruction de premier niveau, et de pi u: 
doit apparaitre avant toute autre instruction. 

</paragraphe> 



<titre3 id="importSemantique.titre.l2.Decoupe"> Semantique</titre3> 

<paragraphe>L'instruction <codeDansTexte avant=" " apres=" ">xsl:import 
</codeDansTexte> permet d'incorporer au fichier source XSLT courant les 
instructions XSLT d'un autre fichier source XSLT dont l'URI est fourni par 
l'attribut <codeDansTexte avant=" " >href</codeDansTexte>. La difference avi 
<codeDansTexte avant=" " apres=" ">xsl :incl ude</codeDansTexte> tient a ce qi 
conflits, en cas de definitions multiples d'une meme instruction XSLT, ne si 
necessai rement des cas d'erreurs, et peuvent etre resolus grace a des regie: 
specifiques. 

</paragraphe> 



<titre4 id="importSemantiqueproc.titre.l3.Decoupe"> Processus mis en (Euvre</titre4> 

<index indexWords="l,4,5">Instanciation de 1 'instruction xsl :import</index> 

<index indexWords="l,3,7,8">Detection de conflits dus a 1 'instruction xsl:import 

</index> 
<index indexWords="l,4,9">Calcul de la preseance des feuilles importees par 
xsl :import</index> 

<paragraphe>Le processus d'incorporation des instructions XSLT provenant d'une 
feuille de style importee est le meme que dans le cas d'une inclusion (voir 
<renvoiVersTitre idRef="incl udeSemantiqueproc.titre.5.Decoupe" avant=" " />). Ce 
qui change, c'est 1 'interpretation du resultat une fois 1 "incorporation terminee. 
On peut exprimer cela assez facilement sur un dessin (voir <renvoiVersFigure 
idRef="include-import.fig.l.Decoupe" avant=" " />, oQ <italiques> A</italiques>, 
<italiques> B</italiques>, <italiques> C</italiques>, et <italiques> D 
</italiques> representent des instructions XSLT quelconques) : dans le cas d'une 
inclusion, la double presence de l'instruction <italiques> B </italiques> pose (en 
general) probleme; mais dans le cas d'une importation, elle ne pose pas probleme. 

</paragraphe> 
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<figure id="incl ude- import. fig. l.Decoupe" dir=" images/ I nstructionsDecoupage" 
file="i nclude-import.eps" legende='Comparaison inclusion-importation'/) 



<remarque titre="Note">La <renvoiVersFigure idRef="include-import. fig. l.Decoupe" 
avant=" " apres=" " /> suggere un conflit potentiel entre 1 'element <italiques> B 
</italiques> de la feuille principal e et 1' element <italiques> B </italiques> de 
la feuille importee. Neanmoins, il faut garder a 1 'esprit qu'une stricte identite 
d'element n'est pas necessaire a 1 'apparition d'un conflit : deux regies de 
transformation de motifs differents peuvent tres bien engendrer un conflit sur un 
certain naud, si les deux motifs concordent simul tanement avec ce noeud. La figure 
est ici un support visuel qui permet de mettre en evidence les endroits ou 1'on 
discute d'un conflit, mais elle ne doit pas faire croire que les conflits ne 
peuvent pas surgir ailleurs. 

</remarque> 

M algre un aspect un peu rebarbatif a la lecture, ce genre de texte est tres rapide a taper 
sousun editeur detextescommeUltraEdit, XEmacsou B B Edit, parce que chaque bali- 
sage peut etre realise par appel d'une macro adequate, apres avoir selectionne le ou les 
mots a baliser. La transformation XSLT d'un chapitre est tres rapide (5 secondes pour 
obtenir 100 pages de document final Word avec Saxon, sur un PC portable PHI), cequi 
permet decontroler tres souvent (sous Word) le rendu du resultatobtenu. 



Description de ia DTD utilisee 

La DTD reprend les idees exprimees plus haut, en evitant au maximum les possibilites 
d'imbrication. Certaines limitations proviennent de la feuille de style Word fournie par 
les editions Eyrolles; parexemple, il n'y a que deux niveaux delistesapuces, probable- 
mentparcequ'il ne serait pas raisonnable, d'un pointdevue redactionnel, d'aller au dela. 

xml-rtf.dtd 

<?xml version='1.0' encoding='UTF-16' ?> 



DTD pour la traduction RTF de documents XML 

Chaque <!ELEMENT ... > correspond a un style de feuille de style 



<!ENTITY % fragmentDeTexte "#PCDATA | subtil | italiques | titreOeuv 
treslmportant | codeDansTexte | 
codeRTFDansTexte I 
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renvoiVersTableau | renvoiVersFigure 
renvoiVersTitre [ espace | 
br | refBiblio 



:! ENTITY % fragmentDeTexteAvecNoteBP "//PCDATA | subtil | italiques | 
titreOeuvre | treslmportant | 
codeDansTexte | codeRTFDansTexte | 
renvoiVersTableau | 
renvoiVersFigure | 
renvoiVersTitre | espace | 
br | noteBP [ refBiblio 



:!ENTITY % elementDeListing "//PCDATA | pseudocode | codeFau> 



- definition des elements 



<!ELEMENT subtil (//PCDATA) > 
<! ELEMENT italiques (//PCDATA) > 

<! ELEMENT titreOeuvre (//PCDATA) > 

<! ELEMENT treslmportant (//PCDATA) > 

<! ELEMENT codeDansTexte (//PCDATA)> 

<!ATTLIST codeDansTexte avant CDATA //IMPLIED > 

<!ATTLIST codeDansTexte apres CDATA //IMPLIED > 

<! ELEMENT codeRTFDansTexte (//PCDATA)> 

<!ATTLIST codeRTFDansTexte avant CDATA //IMPLIED > 

<!ATTLIST codeRTFDansTexte apres CDATA //IMPLIED > 

<! ELEMENT pseudocode (//PCDATA)> 

<! ELEMENT codeFaux (//PCDATA)> 

<! ELEMENT renvoiVersFigure (//PCDATA)> 

<!ATTLIST renvoiVersFigure idRef IDREF //REQUIRED > 

<!ATTLIST renvoiVersFigure avant CDATA //IMPLIED > 

<!ATTLIST renvoiVersFigure apres CDATA //IMPLIED > 

<!ATTLIST renvoiVersTitre postlt CDATA //IMPLIED > 

<! ELEMENT renvoiVersTitre (//PCDATA)> 
<!ATTLIST renvoiVersTitre idRef IDREF //REQUIRED > 
<!ATTLIST renvoiVersTitre avant CDATA //IMPLIED > 
<!ATTLIST renvoiVersTitre apres CDATA //IMPLIED > 
<!ATTLIST renvoiVersTitre postlt CDATA //IMPLIED > 
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C1ELEMENT renvoiVersTableau C//PCDATA)> 

C1ATTLIST renvoiVersTableau idRef IDREF #REQUIRED ) 

C1ATTLIST renvoiVersTableau avant CDATA //IMPLIED > 

C1ATTLIST renvoiVersTableau apres CDATA //IMPLIED > 

(1ATTLIST renvoiVersTitre postlt CDATA //IMPLIED > 



UELEMENT refBiblio (//PCDATA)> 

(1ATTLIST refBiblio idRef IDREF //REQUIRED > 

C1ELEMENT index (//PCDATA)> 

C1ATTLIST index indexWords CDATA //IMPLIED > 

C1ELEMENT espace EMPTY > 

UELEMENT br EMPTY > 

([ELEMENT aerationVerticale EMPTY > 



<!ENTITY % blocDeTexte "partie | titreChapitre | titreAnnexe 
titre2 j titre3 | titre4 | titre5 | 
paragraphe | tableau | remarque | 
figure | listing | listingRTF | 
listingPseudoCode ] 
codeUneLigne | aerationVerticale | 
fichier | liste | 1 isteANumero | 
1 igneCodeAvecCommentai re | 
commentaireLigneDeCode | index | 
titreCode | listingAvecTitre | 
sousTitreCommentai re | 
exemplePourSousTitreDeCommentaire 



<!ENTITY % titre.attributs "id ID //REQUIRED 
numero CDATA //IMPLIED 
indexWords CDATA //IMPLIED 



<!ELEMENT titreChapitre (%f ragmentDeTexte; )* 
<!ATTLIST titreChapitre ^titre.attributs; > 



<!ELEMENT titreAnnexe C&fragmentDeTexte; )* 
<!ATTLIST titreAnnexe ^titre.attributs; > 
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CiELEMENT titre2 (EfragmentDeTexteAvecNoteBP; ) 
(IATTLIST titre2 Uitre.attributs; > 



<! ELEMENT paragraphe UfragmentDeTexteAvecNoteBP; [ index)* > 

<! ELEMENT noteBP UfragmentDeTexte; )* > 

<! ELEMENT remarque (%f ragmentDeTexteAvecNoteBP; | index)* > 
<!ATTLIST remarque id ID //REQUIRED 
titre CDATA ^REQUIRED 



(! ELEMENT figure EMPTY > 

(IATTLIST figure id ID //REQUIRED 

dir CDATA ^IMPLIED 

file CDATA //REQUIRED 

legende CDATA //REQUIRED 



<!ELEMENT listing (%elementDeListing; )* > 

<!ELEMENT listingRTF CSelementDeListing; )* > 

<!ELEMENT 1 istingAvecTitre UelementDeListing; )* > 

<! ELEMENT 1 istingPseudoCode UelementDeListing; )* > 

<! ELEMENT codeUneLigne (//PCDATA) > 

<! ELEMENT fichier EMPTY > 

<!ATTLIST fichier nom CDATA //REQUIRED > 

<!ELEMENT 1 igneCodeAvecCommentaire (//PCDATA) > 

<!ELEMENT commentaireLigneDeCode (%f ragmentDeTexteAvecNoteBP; )* 

<! ELEMENT titreCode (//PCDATA) > 

<!ELEMENT sousTitreCommentaire (//PCDATA) > 

<!ELEMENT exemplePourSousTitreDeCommentai re (//PCDATA) > 



C1ELEMENT listeANumero ( item | liste2 ) 
C! ELEMENT liste ( item | liste2 )+ > 
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UELEMENT liste2 ( item )+ > 

UELEMENT item (Xf ragmentDeTexteAvecNoteBP; )* > 

C1ATTLIST item no CDATA ^IMPLIED > 

UELEMENT tableau ( legende?, titresColonnes , lignes+ ) > 
UATTLIST tableau id ID //IMPLIED > 



UELEMENT tableauSansTitresColor 
UATTLIST tableauSansTitresColor 



( legende?, lignes+ ) > 
id ID ^IMPLIED > 



UELEMENT titresColonnes ( cellule | nouvelleCel 1 ule )* > 
UELEMENT lignes ( cellule j nouvel leCel 1 ule | 

nouvelleLigne )* > 
([ELEMENT legende (Xf ragmentDeTexte; )* > 
UELEMENT cellule (Xf ragmentDeTexteAvecNoteBP; | celbr)* 
UELEMENT nouvel leCell ule EMPTY > 
UELEMENT nouvelleLigne EMPTY > 
UELEMENT celbr EMPTY > 



UELEMENT livre ( partie | chapitre 
UELEMENT chapitre (XblocDeTexte; )* 



Transformation XSLT 

II y a en grostroissortesde model esde transformation a mettreau point: 

• Ceuxqui sontspecifiquementdedies a la traduction RTF d'un element XM L refletant 
un style Word ; parexemple, la traduction en RTF del'element<codeDansTexte>. 

• Ceuxqui sont lies a la presence decaracteres sped aux en RTF, qu'il s'agit dedetecter 
et d'envelopper de telle sorte qu'ils redeviennent non significatifs; par exemple, le 
backslash "\" ou I es accolades ■{}*. 
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• Ceux qui realisent un traitement independant du langage cible, comme par exemple 
certains traitements purement algorithmiques intervenant dans la creation des entrees 
d'index. 

L'ensemble de ces regies et model es nommes n'est pas tout a fait complet, car il ne donne 
que la generation du corps de document RTF proprement dit ; celle du prologue RTF est 
assuree par une regie unique et specifique. 



Prologue 



Un document RTF est constitue d'un prologue etd'un corps de document; lorsqu'il est 
genere par Word, I e prol ogue est un texte assez vol umi neux de 35000 caracteres envi ron ; 
c'est la regie X SLT de traitement de la racine du document X M L qui est chargee de generer 
ce prologue: 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 

xmlns:saxon="http://icl .com/saxon" 

extension-element-prefixes="saxon" 



<xsl :strip-space elements=" 
<xsl:output method='text' 



ncoding="IS0-8859-l' /> 



<xsl :template match='/'> 
<xsl :text> 
<xsl:text>{\rtfl\ansi\ansicpgl252\ucl \deffO\defl angl036\deflangfel036 

{\fonttbl {\f0\froman\fcharset0\fprq2{\*\panose 02020603050405020304}Times I 
Roman ;H\fl\fswiss\fcharsetO\fprq2{\*\panose 020b0604020202020204}Arial ; } 
{\f2\fmodern\fcharset0\fprql{\*\panose 02070309020205020404}Courier New;}{\f3\ 
froman\fcharset2\fprq2{\*\panose 05050102010706020507 }Symbol ; }{\f4\froman\ 
fcharset0\fprq2{\*\panose 02020603050405020304}Times; } 
{\fl4\fnil\fcharset2\fprq2{\*\panose 05000000000000000000}Wingdings; }{\f28\fswis: 
fcharset0\fprq2{\*\panose 020b0506020202030204}Arial Narrow;} 

... etc ... 



{\field{\*\fldinst {\b SECTIONPAGES \\* MERGEFORMAT }}{\fldrslt {\b\l angl024\ 
1 angfel024\noproof 5}}}{\par }}{\*\pnsecl vl l\pnucrm\pnstartl\pnindent720\pnhang 
{\pntxta .)}{\*\pnseclv!2\pnucltr\pnstartl\pnindent720\pnhang{\pntxta . }}{\*\ 
pnsecl vl3\pndec\pnstartl\pnindent720\pnhang{\pntxta . }}{\*\pnsecl v!4\pnlcl tr\ 
pnstartl\pnindent720\pnhang(\pntxta )}} 

{\*\pnseclv!5\pndec\pnstartl\pnindent720\pnhang{\pntxtb (}{\pntxta )}}{\*\pnsecl vl6\ 
pnlcltr\pnstartl\pnindent720\pnhang(\pntxtb (}{\pntxta ) )}{\*\pnsecl v!7\pnlcrm\ 
pnstartl\pnindent720\pnhang(\pntxtb (}{\pntxta )}}(\*\pnsecl vl8\pnlcltr\pnstartl\ 
pnindent720\pnhang{\pntxtb ( }{\pntxta )}}{\*\pnsecl vl9\pnlcrm\pnstartl\ 
pnindent720\pnhang{\pntxtb (}{\pntxta )}} 

</xsl:text> 
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csl:text> 
<xsl : call -template name= 
<xsl :apply-templates/> 



</xsl : tempi ate> 



Note 

D'une maniere genera le, le code RTF genere parWord, et repris tel quel dans les regies de transformation XSLT 
mises au point, est d'une grande verbosite (ou complexity ?), si on le compare a des fichiers RTF obtenus par 
d'autres moyens. Le but etant de pouvoir ouvrir le document obtenu sous Word, il ne m'a pas semble utile de 
chercher a simplifier quoi que ce soit. 



Regies pour la transcription RTF d'un style 

Les regies les plus simples sont celles associees a des elements qui ne sont ni la cible de 
renvois, ni associes a des entrees d'index. Par exemple : 



il:template match=' subtil '> 
<xsl:text>{\cs59\i </xsl:text> 
<xsl :apply-templates mode='noTrim' 
<xsl:text>}</xsl:text> 

csl :template> 



;l:template match='italiques'> 

<xsl:text>{\i </xsl:text> 

<xsl :apply-templates mode='noTrim'/> 

<xsl:text>}</xsl:text> 
csl :template> 



;l:template match='pseudoCode' mode='list 
<xsl:text>{\cs78\i </xsl:text> 
<xsl :apply-templates mode='l isting ' /> 
<xsl:text>K/xsl:text> 

csl :template> 
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<xsl :template match='titreOeuvre'> 
<xsl:text>{\cs6Z\1 </xsl:text> 
<xsl :apply-templates mode='noTrin 
<xsl :text>}</xsl :text> 

</xsl :template> 



= tres important = 



<xsl :template match= 'tres Important '> 
<xsl:text>{\cs60\b </xsl:text> 
<xsl :apply-templates mode='noTrim'/> 
<xsl :text>K/xsl :text> 

</xsl :templ ate> 



Les regies pour la transformation d'elements qui peuvent etre la cible de renvois sont un 
peu plus compliquees, a cause des instructions RTF \bkmkstart et \bkmkend a generer. 



<xsl :template match=' remarque'> 

<xsl :text> 
\pard\plain \s40\qj \1 il418\ri0\sbl60\widctl par\txl418\aspal pha\aspnum\faauto\ 
adjustright\rinO\linl418\itapO \b\f28\fsl8\lang3084\langfel036\cgrid\langnp3084\ 
langfenpl036 { 
{\*\bkmkstart </xsl:text> 

<xsl:value-of select="translate( @id, '.-_', ")"/> 

<xsl:text>}</xsl:text> 

<xsl :cal 1 -template name="instancier-saiitDeLigne"/> 

<xsl:value-of select="@titre"/> 

<xsl :call-template name="instancier-sautDel_igne'7> 

<xsl :text>{\*\bkmkend </xsl :text> 

<xsl:value-of select="translate( @id, '.-_', ")"/> 

<xsl:text» 
\par } 

\pard\plain \s39\qj \1 il418\ri0\sb40\widctlpar 

\txl418\aspalpha\aspnum\faauto\adjustright\rinO\linl418\itapO \fsl8\lang3084\ 
Iangfel036\cgrid\langnp3084\langfenpl036{</xsl:text> 

<xsl :apply-templates/> 

<xsl :cal 1 -template name="instancier-sautDeLigne"/> 

<xsl:text>\par )</xsl:text> 

<xsl :call-template name="instancier-sautDeLigne"/> 

</xsl :templ ate> 
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L'appel a la fonction translate, ci-dessus, a lieu dans toutes les regies definissant des 
signets (bookmark) RTF, car RTF n'accepte pas certains caracteres dans les signets, alors 
qu'ils sont autorises en XM L pour former un identifiant. Par securite, les occurrences 
eventuelles de I'un des 3 caracteres ' .-_■ pouvant intervenir dans un identifiant XML 
sontsupprimeesdu signet RTF. 

La categorie suivante est celle des regies associees a des elements qui peuvent etre la 
ciblede renvois, etcontenir des directives d'entreesd'index : 



<xsl : tempi ate match='titre2'> 

<xsl:text> 
\pard\plain \s2\ql \1 i0\ri0\sb500\keep\keepn\widctlpar\aspalpha\aspnum\faauto\ 

outlinelevell\adjustright\rinO\linO\itapO \b\fl\fs28\langl024\l angfel024\cgrid\ 

noproof\langnpl036\langfenpl036 



\*\bkmkstart </xsl:text> 




<xsl:value-of select="translate( @id, '.-_', ")"/> 




<xsl:text>}</xsl:text> 




<xsl :cal 1 -tempi ate name="instancier-sautDel_igne"/> 




<xsl :apply-templates/> 




<xsl :cal 1 -tempi ate name="instancier-sautDel_igne"/> 




<xsl :text>{\*\bkmkend </xsl :text> 




<xsl:value-of select="translate( @id, '.-_', ")"/> 




<xsl:text>}</xsl:text> 




<xsl :call-template name="instancier-sautDel_igne"/> 




<xsl : if test="@indexWords"> 




<xsl :call -tempi ate name="instancier-XEntries"> 




<xsl :with-param name="l istOfNumbers" select^ 


"@indexWords"/> 


<xsl :with-param name="stringToSpl it" select^ 


"normal ize-space( 


</xsl:call -template) 




</xsl:if> 




<xsl :cal 1 -tempi ate name="instancier-sautDel_igne"/> 




<xsl:text>\par }</xsl:text> 




<xsl :cal 1 -tempi ate name="instancier-sautDel_igne"/> 





</xsl :template> 

Le modele nomme instancier-xEntries permet de generer les entrees d'index. Par 
exemple, avec letitresuivant: 



-■"importSemantiqueinter.titre.l4.Decoupe" indexWords="l,4,5"> Interet 
;ruction xsl :import</titre4> 
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on aura les entrees d'index suivantes : 

{\xe \v{Interet de 1' instruction xsl : import}} 
{\xe \v{instruction xsl: import (Interet de V)}} 
{\xe \v(xsl :import (Interet de l'instruction )}} 

En effet, I 'attri but indexwords donneles numeros de mots du titrequi doiventsetrouver 
places en premier dans chaque entree d'index. Seuls les caracteres apostrophe et espace 
sont separateurs de mots, xsl : import est done considers comme un seul mot. 

Regies pour rendre inoffensifs certains caracteres en RTF 

Ces regies concernent surtout la fa§on de rendre un texte non balise, pouvant conteni r des 
caracteres anodins en XML, mais significatifs en RTF. 



<xsl :template match='text() '> 

<xsl : call -tempi ate name="instancier-texteAvec 
<xsl :with-param name="texte" select="noriT 

</xsl:call -template) 
</xsl: template) 



<xsl :template match='text( ) ' mode='noTrim'> 

<xsl : call -tempi ate name="instancier-texteAvec -escape- accolades" 
<xsl :with-param name="texte" select="." /> 



-template) 
</xsl: template) 



<xsl :template match='text( ) 












<xsl :call -template name= 


"instanc 


er-texteAve 


-RTFpar-et-e 


scape- 


accol ades 


<xsl :with-param name 


=" texte" 


select="tra 


slatet . , '«»' 


,'< 


)')" /> 


</xsl:call -tempi ate) 












</xsl :templ ate) 
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<xsl : tempi ate match='text() ' mode='l istingRTF'> 
<xsl : call -tempi ate 
name="instancier-texteAvec-RTFpar-et-escape-accolades-et- backs 1 



<xsl :with-param r 
</xsl :cal 1 -template> 
</xsl :template> 



<xsl :template r 
<xsl :param 

<xsl : variable name="codeSource2"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-accolades-gauches" 
<xsl :with-param name="codeSource" select="$texte" /> 

</xsl: call -tempi ate> 
</xsl: van" able) 

<xsl :variable name="codeSource3"> 

<xsl :call -tempi ate name="instancier-texteAvec-escape-accol ades-droites" 
<xsl :with-param name="codeSource" select="$codeSource2" /> 

</xsl: call -tempi ate) 
</xsl: van" able) 



<xsl :copy-of select="$codeSource3"/> 
</xsl :template> 



;1 : tempi ate name= 'ins tancier-texteAvec-RTFpar-et -escape- acccf 
<xsl:param name="texte" /> 

<xsl variable name="codeSourcel"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-RTFpar") 
<xsl :with-param name="codeSource" select="$texte" ; 

</xsl:call -tempi ate) 
</xsl: van" able) 



<xsl :variable name="codeSource3"> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-accol a 
<xsl :with-param name="texte" select="$codeSourcel" /> 

</xsl: call -tempi ate) 
</xsl:variable> 
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<xsl :copy-of select="$codeSource3"/> 
</xsl: template) 



<xsl :template 
name='instancier-texteAvec-RTFpar-et-escape-accolades-et-backslash') 

<xsl:param name="texte" /> 

<xsl :variable name="codeSource3"> 

<xsl : call -tempi ate name="instancier-texteAvec-escape-backsla; 
<xsl :with-param name="codeSource" select="$texte" /> 

</xsl :call -template) 
</xsl:variable> 

<xsl : van" abl e name="codeSourcel") 
<xsl :cal 1 -template 
name="instancier-texteAvec-RTFpar-et-escape- accolades") 

<xsl :with-param name="texte" select="ScodeSource3" /> 
</xsl : call -template) 
</xsl variable) 

<xsl :copy-of select="$codeSourcel"/> 
</xsl :templ ate) 



<xsl :template name="instancier-texteAvec-RTFpar"> 
<xsl:param name="codeSource" /> 
<xsl :choose) 

<xsl :when test="contains( ScodeSource, '
' )"> 

<xsl :value-of select="substring-before( ScodeSource, '
' )" 
<xsl :cal 1 -template name="instancier-sautDeLigne"/> 
<xsl :text>\par </xsl:text> 

<xsl :cal 1 -template name="instancier-texteAvec-RTFpar"> 
<xsl :with-param name="codeSource" 

select="substring-after( ScodeSource, '
 ' 
</xsl: call -template) 
</xsl:when> 

<xsl :otherwise) 
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<xsl :value-of select="ScodeSourc 
</xsl: otherwise) 
</xsl :choose> 
</xsl: template) 



<xsl :template name="instancier-texteAvec-escape-backslash"> 
<xsl:param name="codeSource" /> 
<xsl :choose> 

<xsl :when test="contains( ScodeSource, 'V )"> 

<xsl :value-of select="substring-before( ScodeSource, 'V )" /> 
<xsl:text>\\</xsl:text> 

<xsl :cal 1 -tempi ate name="instancier-texteAvec-escape-backslash"> 
<xsl :with-param r,ame="codeSource" 

select="substring-after(ScodeSource, '\' )" /> 
</xsl: call -template) 
</xsl :when> 

<xsl:otherwise> 

<xsl :value-of select="ScodeSource'7> 
</xsl otherwise) 
</xsl :choose) 
</xsl :template> 



<xsl : tempi ate name="instancier-texteAvec-escape-accolades-gauches"> 
<xsl:param name="codeSource" /> 
<xsl :choose> 

<xsl :when test="contains( ScodeSource, '{' )"> 

<xsl :value-of select="substring-before( ScodeSource, '{' 
<xsl:text)\{</xsl:text> 
<xsl :call-template 

name="instancier-texteAvec-escape-accolades-gauches"> 
<xsl :with-param name="codeSource" 

select=" substring -after (ScodeSource, 
</xsl :cal 1 -template) 
</xsl :when> 

<xsl : otherwise) 

<xsl :value-of select="ScodeSource"/> 
</xsl :otherwise> 
</xsl :choose) 
</xsl :template) 
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<xsl :template name 
<xsl :choose> 



;1 :when test="contains( ScodeSource, '}' )"> 
<xsl :value-of select="substring-before( ScodeSource, ' 
<xsl:text>\}</xsl:text> 

<xsl :cal 1 -template 

name="instancier-texteAvec-escape-accolades-droites"> 
<xsl :with-param name="codeSource" 

select="substring-after($codeSourc 
</xsl :call -template> 
(si :when> 

;1 :otherwise> 

<xsl :value-of select="$codeSource"/> 
<sl :otherwise> 



</xsl:choc 
</xsl :template> 



<xsl :template name="instancier-sautDel_igne"> 

<xsl:text> 
</xsl:text> 
</xsl :template> 

On notera que certains modeles nommes sont recursifs (instancier-texteAvec-escape- 
accoi ades-droi tes par exemple), mais tous sont sur le modele d'une recursion terminal e. 



Entrees d'index 



La generation des entrees d'index est la partie la plus complexe de la transformation, 
mais la difficulty est algorithmique, et independante du choix du langage cible RTF. II 
s'agit, a partir d'une chaine de caracteres et d'une listedenumeros demots, deproduire 
di verses permutations de mots dans la chaine de caracteres initiale. 

Par exemple, avec la chaine « detection de conflits dus a instruction xsl:import» et la 
liste de numeros de mots « 1,3,7,8 », il faut produire les permutations (les separateurs de 
mots sont I'apostrophe et I'espace ) : 

• detection de conflits dus a instruction xskimport 

• conflits dus a I'instruction xskimport (Detection de) 
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• instruction xsl: import (Detection de conflits dus a I') 

• xskimport (Detection de conflits dus a I 'instruction) 

L'ensemble de ces entrees est produit par le modele nomme instancier-xEntries, qui 
lui-memeappellelemodeleinstancier-xEntry nfois, unefoisparnumero demot. Cha- 
cun de ces appels produit une permutation, qui est habillee de code RTF par le modele 

instancier-indexEntry. 

<xsl :template name="instancier-XEntry"> 
<xsl :param name="blankNumber"/> 
<xsl :param name="stringToSpl it"/> 

<xsl :variable name="before_after"> 

<xsl :call -tempi ate name="instancier-stringSplits"> 

<xsl :with-param name="blankNumber" select="$bl ankNumber"/> 
<xsl :with-param name="stringToSplit" select="$stringToSplit"/> 
</xsl: call -tempi ate> 
</xsl:variable> 

<xsl variable name="wordsBefore"> 

<xsl:value-of select="$before_after//before" /> 
</xsl: van" able) 



si variable name 


="wordsBefore-pa 


ren"> 






<xsl :choose> 
<xsl :when 
(<xsl 
</xsl:wher 


test="normalize- 
value-of select= 


spacet 
"$word 


words 
Befor 


Before)" 
e" />) 


<xsl :otherwise> 
</xsl:otherwise> 
</xsl :choose> 








xsl:variable> 










si variable name 
<xsl:value-of 
xsl:variable> 


="wordsAfter"> 
select="$before_ 


after//after 


" /> 



<xsl :variable name="theEntry"> 

<xsl:value-of select="$wordsAfter'7Xxsl :text> </xs 
<xsl :value-of select="$wordsBefore-paren"/> 

</xsl:variable> 

<xsl :cal 1 -tempi ate name="instancier-indexEntry"> 

<xsl :with-param name="entry" select="$theEntry"/> 
</xsl :call-template> 

</xsl :template> 
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<xsl : tempi ate narr 




nstancier-XEntries"> 






<xsl :param na 




listOfNumbers"/> 






<xsl:param na 




stringToSpl it"/> 






<xsl :choose> 


tes 


t="contains($listOf Number 


, ■«■)-> 




<xsl: 


van 


able name="aNumber"> 








xsl: 


value-of select="substrin 


-before( 


SlistOfNumbe 


</xsl 


:var 


iable> 







<xsl :call -template name="instancier-XEntry"> 

<xsl :with-param name="blankNumber" select="$aNumber - l"/> 

<xsl :with-param name="stringToSpl it" select="$stringToSpl it"/> 
</xsl: call -tempi ate> 
<xsl :cal 1 -template name="instancier-XEntries"> 

<xsl :with-param name="l istOfNumbers" 

select="substring-after($listOfNumbers, ' , ' )"/> 

<xsl:with-param name="stringToSpl it" select="$stringToSpl it'7> 
</xsl:call-template> 

</xsl:when> 

<xsl: otherwise) 

<xsl:if test="$listOfNumbers"> 

<xsl :choose> 

<xsl :when test="number($l istOfNumbers) = 1"> 

<xsl : call -tempi ate name="instancier-indexEntry"> 
<xsl :with-param name="entry" 

select="$stringToSplit'7> 
</xsl : call -tempi ate> 
</xsl:when> 



<xsl :call -template name="instancier-XEntry"> 
<xsl :with-param name="bl ankNumber" 

select="number($l istOfNumbers) 
<xsl :with-param name="stringToSpl it" 

select="$stringToSp1it°/> 
</xsl : call -tempi ate> 
</xsl :otherwise> 
</xsl :choose> 
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</xsl :template> 



<xsl :template name="instancier-indexEntry"> 

<xsl:param name="entry"/> 

<xsl:text>{\xe \v{</xsl :text> 

<xsl :val ue-of select= "normal ize-space($entry)"/> 

<xsl:text»}</xsl:text> 
</xsl :template> 

<!--> 



il:template match=' index '> 

<xsl : variabl e name="wordNumbers"> 

<xsl :val ue-of select="@indexWords"/> 
</xsl :variable> 



<xsl : call -tempi ate name="instancier-XEntries"> 

<xsl :with-param name="listOfNumbers" select="$wordNumbers 
<xsl :with-param name="stringToSplit" 

select="normalize-space($entries)"/> 
</xsl :call-template> 
</xsl :when> 

<!-- cas ou il n'y a pas de liste de numeros de mots : --> 
<!-- le contenu constitue 1 'entree d'index --> 

<xsl :otherwise> 

<xsl : variable name="theEntry"> 
<xsl :apply-templates/> 

</xsl:variable> 
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:all -template name="instancier-indexEntry"> 
;sl :with-param name="entry" 

select=" normal ize-space($theEntry)"/> 
call -tempi ate> 



</xsl :templ ate> 

Etant donne une chaine s composee de mots separes par des apostrophes ou des espaces, 
et un nombre 1 fournis en donnee, le modele nomme instancier-stringSpiits a pour 
but de produire 3 morceaux de chaines de caracteres : la sous-chaine de s situee avant le 
ieme separateur, le separateur, et la sous- chaine de s situee apres le ieme separateur. 
Cette fonction repose sur une definition recursive de la notion «d 'avant et d'apres le 
ieme separateur ». Si on appelle s la chaine donnee, et t la chaine s privee de son pre- 
mier mot, on peut dire que (conformement ace qui estmontre par la figureA-1) : 

• ce qu'il y a apres le 1 erne separateur dans s, c'est ce qu'il y a apres le 1-1 erne sepa- 
rateur dans t ; 

• ce qu'il y a avant le 1 erne separateur dans s, c'est ce qu'il y a avant le 1-1 erne sepa- 
rateur dans t, concatene au premier mot de s. 

Cette definition vaut pour 1 superieural ; lorsquei estegal a 1, c'est uncas trivial, puis- 
quelesfonctionsXSLT predefines subst ring-before o etsubstring-aftero donnent 
directement I e resultat cherche. 

On notera que la recursion, ici, n'est pas terminal e, a cause de la concatenation a effectuer 
a partir du resultat obtenu recursivement. II serait possible de la rendre terminal e, mais ce 
n'est pas du tout une necessite, car la profondeur de recursion est egale au nombre 
d'entrees a generer pour une meme phrase, qui n'est jamais tres grand (presque toujours 
inferieur a 5). 



Figure A-l 

De'coupaged'unechafne 
en 3 morceaux. 



Void le modele nomme instancier-stringSpiits : 

|<xsl template name="instancier-stringSpl its"> 
<xsl :param name="blankNumber"/> 
<xsl :param name="stringToSpl it"/> 
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<xsl :when test="$bl ankNumber = 1"> 

<xsl:variable name="result"> 
<xsl :cal 1 -tempi ate 
name="stringSpl its-beforeAndAfter-firstSeparatc 

<xsl :with-param name="stringToSpl it" 

select="$stringToSplit'7> 



<xsl:copy-of select="$resul t" /> 
</xsl :when> 



<xsl:when test="$blankNumber = 0"> 

<xsl:variable name="result"> 
<split> 

<before/> 
<after> 

<xsl:value-of select="$stringToSpl it" /> 
</after> 
</split> 
</xsl:variable> 

<xsl:copy-of select="$result" /> 

</xsl :when> 



<xsl :otherwise> 



<xsl variable name="before_after"> 
<xsl :call -tempi ate 
name="stringSplits-beforeAndAfter-firstSeparator" 



:with-param name="stringToSpl it" 

select="$stringToSplit"/> 
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5-of select="$before_after//separator" /> 



2-of select="$before_after//after" /> 



'ariable name=" recurs ive_before_after"> 

;sl : call -tempi ate name="instancier-stringSpl its"> 

<xsl :with-param name="blankNumber" 

select="number($blankNumber)-l"/> 

<xsl:with-param name="stringToSpl it" select="$after'7> 
'xsl :cal 1 -template> 
variable> 



variable naim 
;split> 

<before> 
<xsl:\ 



5-of select="$ recurs ive_before_after//after"/> 



<xsl :copy-of select^' 
</xsl :otherwise> 



</xsl :templ ate> 



Feuille de style complete 

La feuillede style complete, ainsi que la DTD, est disponiblesurle site internet des edi- 
tions Eyrolles : www.editions-eyrolles.com (taper D rix dans leformulaire de recherche rea- 
pide). 



B 



Les instruction menageres 



Les instructions XSLT que nous appelons nv'nag<?res sont des instruction qui servent a regl 
quelques parametres pour la lecture de la source X M L ou I 'ecriture du document resultat. 

Cela COnceme les instructions xsl: stylesheet, xsl :namespace-alias, xsl :outpu 
xsl :decimal -format, xsl :preserve-space, etxsl : strip-space. 

Instruction xshstylesheet 
Syntaxe 

xsl tstylesheet 

<xsl :stylesheet 



xsl :transform 



L'element xsi stylesheet est la racine d'un document XSLT. xsi :transform est un 
synonyme de xsi stylesheet. L'attribut version est obligatoirement egal a 1.0, du 
moinstant que la version 2.0 nesera pas officiellement disponible. 

Note 

La version 1.1 ne sera jamais officiellement disponible. 
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Variantes syntaxiques 

xsl : stylesheet 

<xsl :stylesheet 



i-element-prefix 
-esult-prefixes= 



La valeur de ces deux attributs facultatifs est fournie sous la forme d'une liste de prefixes 
separes par des espaces blancs. 

A ttribut extension-element-prefixes 

Cetattribut permetau processeurXSLT dedistinguerdeselementsXML litteraux ains- 
tancier tels quels et des elements XML qui se trouveraient etre en realite de nouvelles 
instructions XSLT proposees comme extensions par tel outel processeur parti culier. Les 
prefixes a fournir doivent bien sur faire parti e des prefixes declares avec les domaines 
nominaux dans I 'instruction xsi :styiesheet elle-meme. 

Par exemple, I'extension <saxon:entity-ref name="nbsp"/> permet d'emettre dans le 
fichier de sortie la referenced I'entite nbsp proprea HTML. Pour I'utiliser, il fautdonc 
declarer le domaine nominal de Saxon, puis le prefixe correspondant (saxon, en I 'occur- 
rence) dans la liste des extension-element-prefixes. Ci-dessous un exemple, qui 
reprend I 'exemple vu a la section Realisation avec recherche par expression XPath, 
page 473 : 

Saison.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/Transform" 

xmlns:saxon="http://icl .com/saxon" 

extension-element-prefixes="saxon" 

version="1.0"> 

<xsl:output method='html' encodings' ISO-8859-1' /> 

<xsl :template match="/"> 
<html> 
<head> 

<title>Programme Saison 
<xsl:value-of 

select="/Sai son/Peri ode"/X/title> 
</head> 
<body bgcolor="white" text="black"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :template> 
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si :template m 


atch="Saison" 




<xsl :apply-templates sel 


2ct="Manifestat 


<H3>Adresse 


s :</H3> 




<xsl :apply-templates sel 


2ct="Adresse"/> 


xsl :template> 






si :template m 


atch="Concert 


Theatre"> 


<H3Xxsl:va 


ue-of select 


="local-name(.) 


<p><saxon:e 


ntity-ref nam 


3="nbsp"/> 


<saxon:e 


ntity-ref nam 


2="nbsp"/> 


<saxon:e 


ntity-ref nam 


2="nbsp"/> 


<saxon:e 


ntity-ref nam 


2="nbsp"/> 


Date : < 


xsl :value-of 


5 elect="Date"/> 


<saxon:e 


ntity-ref nam 


3="nbsp"/> 


<saxon:e 


ntity-ref nam 


2="nbsp"/> 


<saxon:e 


ntity-ref nam 


2="nbsp"/> 


<saxon:e 


ntity-ref nam 


2="nbsp"/> 


Lieu : < 


a href="#{generate-id( 




/Sa 

[ . 


son/Adresse/Li 
= current()/Li 
select="Lieu'7 


</p> 






xsl : tempi ate> 







<xsl :template match="Adresse"> 

<p><a name="#{generate-id( . /Lieu)}"> 
<xsl:value-of select="Lieu"/X/aXbr/> 
<xsl:val ue-of sel ect=". /child: :text()[2]"/> 
</p> 

</xsl :template> 

<xsl template match="text( )"/> 



</xsl: stylesheet) 

Etvoici cequeceladonne: 

Saison.html 

r<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-l") 

<title>Programme Saison Automne 1999 </title> 



Les instruction menageres 



<body bgcolor="white" text="bla 
<H3>Concert</H3> 



:k"> 



<p>     

Date : Samedi 9 octobre 1999 20H30 <br 

     

Lieu : <a href="#d0e56">Chapel le des Urs 
<H3>Théâtre</H3> 



<p> &nbsp 
Date 

&nbsp 
Lieu 



   

Mardi 19 novembre 1999 21H <br> 
    

<a href="#d0e62">Salle des Cordel iers</a> 



<H3>Théâtre</H3> 



<p> &nbsp 
Date 



   
Mercredi 20 novembre 1999 21H30 <t 
    
<a href="#d0e62">Salle des Cordelier 
s :</H3> 

"#d0e56">Chapelle des Ursules</aXbr> 
, rue des Ursules - 49000 Angers 



="#d0e62">Salle des Cordel iers</a><br> 

1, rue des Prévoyants de 1'avenir - 49000 Angers 



</p> 
</body> 
</html> 



Attribut exclude-result-prefixes 

C et attri but demande au processeur de ne pas emettre de decl arati on de domai ne nomi nal 

pour les domaines nominaux references par les prefixes fournis comme valeur de cet 

attribut. 

Comme le processeur XSLT est oblige degenererun document XML correct, il passera 
outre votre demande, si le domaine nominal que vous voulez exclure du resultat est en 
fait utile. Mais si le domaine nominal vise est effectivement inutile dans le document 
genere, votre demande sera prise en compte. Le processeur XSLT ne peut pas deviner 
tout seul si un domaine nominal est vraiment inutile, parce que XML autorise d'utiliser 
les domaines nominaux meme sur des valeurs d'attribut : 



II n'est pas interdit d'avoir une valeur d'attribut qui soit "machin: chose" ; dans cette 
chaine de caracteres, "machin" est-il un prefixe, ou simplement le debut d'une valeur ou 
il y a un " : " au milieu ? Si en plus il se trouve que machin est reellement un prefixe 
declare pour un certain domaine nominal, le processeur XSLT ne peut plus s'y retrouver 
poursavoirsi ce domaine nominal est utile ou non. Done les processeurs XSLT n'ontpas 
a decider eux-memes ; e'est a vous de dire lesquels exclure. 
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Instruction xshnamespace-alias 

Syntaxe 

xsi :namespace-al ias 

<xsl :namespace-al ias 

stylesheet-prefix=" ..." 

result-prefix=". . ." 
/> 

L'instruction xsi :namespace-aiias doit apparaitre comme instruction de premier niveau. 

Semantique 

L'instruction xsi :namespace-aiias permet de specifier qu'un element I itteral XML, pre- 
sent dans la feuille de style XSLT, et associe a un domaine nominal Nl, sera instancie 
dans le document resultat comme etant associe a un autre domaine nominal N2. Comme 
d'habitude, les domaines nominaux concerned sont designes par les prefixes qui les iden- 
tified, cequi rend leschosesun peutroubl antes, car on peutcroirequ'il s'agitseulement 
de changer deprefixe (sans changer de domaine nominal), alorsqu'il s'agitbel etbien de 
changer de domaine nominal (et accessoirement de prefixe, mais comme vous le savez, 
un prefixe n'a aucune importance en lui meme). 

Le prefixe du domaine nominal Nl est indique par I'attribut stylesheet-prefix, et le 
prefixe du domaine nominal N2 par I'attribut result-prefix, de sorte que l'instruction 
xsi : namespace-aiias permettant de passer du domaine http://machin (prefixe mm:) au 
domai ne http : //true (prefixe tt : ) aura I 'al I ure suivante : 

<xsl :namespace-al ias 

stylesheet-prefix="mm" 
result-prefix="tt"/> 

Ceci neveut pasdu tout dire que les elements litteraux deprefixe mm: apparaitront dans le 
document resultat avec le prefixe tt:, mais que les elements litteraux de domaine nominal 
http ://machin apparaitront dans le document resultat associesau domaine nominal http:// 



Concert.xml 

<?xml version="1.0" encoding="UTF-16" standalor 



<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 
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<Nom> Jonathan Dunford </Nom> 



<Instrument>Bass 
</Interprete> 

<Interprete> 

<Nom> Sylvia Abr 
<Instrument>Bass 

</Interprete> 
</Interpretes> 



)le</Instrument> 



Concert.xsl 

<?xml version="1.0" encoding="UTF-16"?> 
<xsl :stylesheet 

xmlns:xsl="http: //www. w3.org/1999/XSL/TransforiT 

xmlns:mm="http://inachin" 

xmlns:tt="http://truc" 

version="1.0"> 



<xsl:output method='xnl' encodings ISO-8859-1' indent='yes' /> 
<xsl :namespace-alias stylesheet-prefix="mm" resul t-prefix="tt"/> 

<xsl : tempi ate match="Interpretes"> 

<mm:Musiciens> 

<xsl :copy-of select="Interprete"/> 

</mm:Musiciens> 
</xsl :template> 

<xsl :template match="text( )"></xsl :template> 

</xsl:stylesheet> 

Resultat 

<?xml version="1.0" encoding="IS0-8859-l"?> 
<mm:Musiciens xmlns:mm="http://truc" xmlns:tt="http://truc"> 
<Interprete> 

<Nom> Jonathan Dunford </Nom> 

<Instrument>Basse de viole</Instrument> 

</Interprete> 
<Interprete> 

<Nom> Sylvia Abramowicz </Nom> 

<Instrument>Basse de viole</Instrument> 



Instruction xshfallback 



</Interprete> 
</mm:Musiciens> 

Tout cela est assez admirable (plus admirable qu'imitable, d'ailleurs), mais a quoi cela 
peut-il bien servir? 

La principaleutilite estdepouvoirecrireunefeuilledestyleXSLT qui generecommeresultat 
une autre feui lie de style XSLT. On sereportera a la section Pattern n° 15 -Generation d'une 
feuille de style par une autre feuille de style, page 507 pour en voir un exemple. 
En effet, si I 'on a des instructions XSLT aemettredansleresultaten tant qu'elements lit- 
teraux, il fauttrouver un moyen pour que leprocesseur XSLT nelesprennepas pour lui, 
en tant qu'instructions a executer. La solution est de declarer ces instructions dans un 
domaine nominal autre que celui d'XSLT, et de demander a ce que dans le document 
resultat, ces elements apparaissent dans le domaine nominal X SLT. 

Instruction xshfallback 

Syntaxe 

xsltfallback 
<xsl:fa11back> 

<!-- modele de transformation --> 
</xsl:fallback> 

L'instruction xsi :xsi : f ai i back ne doit pas apparaitre comme instruction de premier niveau. 

Instruction XSLT typique 

U ne instruction XSLT uti I isant I 'instruction xsi :fai iback aura souvent la forme : 

<xsl :xxx> 

<!-- modele de transformation propre a xsl:xxx --> 

<xsl: fall back) 

<!-- modele de transformation propre a xsl:fallback --> 

</xsl :fallback> 
</xsl :xxx> 

L'effet de cette instruction est le suivant : si xsi :xxx est une instruction connue du pro- 
cesseurXSLT, instruction xsi fallback (et cequ'elle contient) estignoree. Si xsi :xxx 
est une instruction inconnue du processeur XSLT, l'instruction xsi fallback qu'elle 
contient est instanciee. 

Cela sert dans lecas ou on lance un processeur XSLT 1.0 surun source XSLT d'une ver- 
sion ulterieure, contenant eventuellement des instructions qui n'existaient pas encore 
dans la 1.0, ou bien dans lecas ou I 'on uti I ise des instructions horsnorme (des extensions 
fournies par tel ou tel processeur) dans un programme source qui est susceptible d'etre 
traite par differents processeurs. 
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Instruction xshpreserve-space 
Instruction xshstrip-space 

Syntaxe 

xsl :preserve-space 

<xsl :preserve-space elements=" 



tsl :strip-space 

<xsl :strip-space 



Les instructions xsi :preserve-space et xsi : strip-space doivent apparaitre comme 
instructions de premier niveau. 

Semantique 

^instruction <xsi :strip-space> sert a eliminer les noeuds text ne contenant que des 
espaces blancs de I'arbre XML construit par leprocesseurXSLT. Voir la section Exem- 
ple, page 170, et la section Realisation avec recherche par expression XPath, page 473. 

L'instruction <xsi :preserve-space> permet de contredire localement I'instruction 
<xsi :strip-space>. General ement, on nel'emploiepasseule, carsoneffetestl'effetpar 
defaut. 

Par exemple, pour activer la suppression des noeuds text blancs comme neige, sauf pour 
ceux qui sont des enfants de <truc> ou <bidui e>, on ecrira : 

<xsl :strip-space elements="*"/> 
| <xsl :preserve-space elements="truc bidule"/> 

Instruction xshoutput 
Syntaxe 



xsl :output 






<xsl :Output 






method ="..." < 


- "xml" | 


•html" | 


encoding = " . . . " 






omit-xml -declarat 


on = "..." 


<!-- "ye 


standalone = "... 


<!-- "yes" 


| "no" 


doctype-publ ic = 


..." <!-- s 


tring -- 


doctype-system = 


..." <!-- s 


tring -- 


cdata-section-elen 


ents = "... 




indent = ". . ." <! 


- "yes" ] " 


no" --> 


media-type = "... 


<!-- strin 


g --> 



Instruction xshoutput 



Tous les attributs sontfacultatifs. 

L'instruction xsi output doit apparaitrecomme instruction de premier niveau. 



Semantique 



L'instruction xsi : output permetaux auteurs defeui 1 1 esde style de specifier la maniere 
dont ils souhaitent produire I'arbre resultat. Le processeur doit faire pour le mieux, 
sans etre oblige toutefois de suivre a lettre toutes les directives fournies par les diffe- 
rents attributs. 

LeS attributs principaUX SOnt method, encoding et indent. Notamment I'attribut method 

estcelui qui est le plus lourd de consequence sur I 'aspect du document resultat. 

L'attribut method identifie la methode general e qui doit etre utilisee pour produire I'arbre 
resultat. Sa valeur doit etre un nom qualifie. S'il n'est pas prefixe, alors il identifie 
I'unedestroissuivantes : xmi, html ou text. Si lenom qualifie est prefixe, alors c'estune 
methode non standard fournie par un processeur parti culier. 

En I'absence d'attribut method, le processeur tente de reconnaitre la nature du fichier 
source; s'il reconnait del 'HTML, la methode par defaut sera 'html' ; sinonellesera'xmT. 

Les autres attributs sont: 

• version : specifie la version dela methode de sortie (par exemple« 1.0 »). 

• indent : demandeou non ('yes'ou 'no') une indentation du fichier de sortie. 

• encoding : specifie le systeme d'encodage des caracteres du fichier de sortie. 

• media-type : specifie le type MIME du fichier de sortie. 

• doctype-system : specifie I'identifiant systeme qui doitetre utilise dans la declaration 
deDTD. 

• doctype-pubiic : specifie I'identifiant public qui doit etre utilise dans la declaration 
deDTD. 

• omit-xmi-deciaration : demande ou non ('yes' ou 'no') une declaration XML en 
debut de fichier. 

• standalone : specifie la valeur ('yes' ou 'no') de la declaration standalone=« ... » 

• cdata-section-ei ements : specifie une liste de noms d'elements dont les fils de type 
text doivent etre produits en tant que section CDATA dans I 'arbre resultat. 

La signification precise de ces attributs en fonction de la methode choisie (text, xmi ou 
html) est treslongueet sans grand interetd'un point devue general. On sereportera au 
standard XSLT pour tel ou tel detail. 
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Instruction xskdecimal-format 

Syntaxe 



xsi :decimal -format 



decimal -separator ="..." <!-- c 
grouping-separator = "..." <!-- c 
infinity = "..." <!-- string --> 
." <!-- char --> 



percent = 
per-mille 



char - 



zero-digit = 

digit = "..." <!-- ch 

pattern-separator = " 



Tous les attributs sont facultatifs. 

L'instruction xsi :decimai -format doit apparaitre comme instruction de premier niveau. 



Semantique 



Cette instruction s'utiliseexclusivementavec lafonction format-numbero. Ellen'a rien 
a voir avec instruction xsi : number, ni avec lafacon dont les conversions de String en 
nombre sont effectuees. II s'agituniquementici de format de sortie pour un nombre deja 
calcule par ailleurs. 

L'attribut name permet de declarer un format nomme, qui pourra etre ensuite reference 
dans un appel a la fonction format-number( ), en tant que troisieme argument. Si l'attri- 
but name est omis, ^instruction xsi decimal -format specifie un format par defaut, qui 
pourra ensuite etre reference en appelant la fonction format-number o avec seulement 
deux arguments. 

M is a part I ' attri but name, les autres attri buts correspondent aux couples de methodes get/ 
set delaclassejava Decimal Formatsymbois duJDK 1.1 (une paire par attribut). 

Certains de ces attributs permettent de control er aussi bien I 'interpretation des caracteres 
du motif de format que de specifier ceux qui peuvent apparaitre dans le resultat de forma- 
tagedu nombre: 

• decimal -separator indique le caractere utilise pour marquer un point decimal ; la 
valeur par defaut est I e caractere point '. '. 

• grouping-separator indique le caractere utilise comme separateur de groupes (par 
exemple mill iers) ; la valeur par defaut est la virgule ' ,'. 



Instruction xshdecimal-format 



• percent indique le caractere utilise pour le signe pourcent ; la valeur par defaut est le 
caractere pourcent'%'. 

• per-miiie indique le caractere utilise pour le signe pour-mille; la valeur par defaut 
est le caractere Unicode pour-mille(#x203o). 

• zero-digit indique le caractere utilise pour lechiffre zero ; la valeur par defaut est I e 
chiffre zero 'o'. 

D'autres control ent I 'interpretation des caracteres dans le motif de format : 

• digit indique le caractere utilise pour un chiffre dans le motif de format; la valeur 
par defaut est le caractere diese '#'. 

• pattern-separator indique le caractere utilise dans un motif, pour separer les sous- 
motifs representant des nombres positifs des sous motifs representant des nombres 
negatifs ; la valeur par defaut est le caractere point-virgule V. 

Enfin ceux-ci indiquent les caracteres ou les chaines de caracteres pouvant apparaitre 
dans le resultat de formatage d'un nombre : 

• infinity indique la chaine de caracteres utilisee pour representer I'infini ; la valeur 
par defaut est la chaine de caracteres inf ini ty. 

• NaN indique la chaine de caracteres utilisee pour representer la valeur de NaN (Not a 
N umber) ; la valeur par defaut est la chaine de caracteres NaN . 

• minus-sign indique le caractere utilise comme signe moins par defaut; la valeur par 
defaut est le caractere moins (-, #x2D). 



Exemple 



<?xml version="1.0" encoding="UTF-16" standalone=" 

<Concert> 

<Entete> "Les Concerts d'Anacreon" </Entete> 
<Date>Jeudi 17 Janvier 2002, 20H30</Date> 
<Lieu>Chapelle des Ursules</Lieu> 

<Ensemble> "A deux violes esgales" </Ensemble> 

<Compositeurs> 

<Compositeur>M. Marais</Compositeur> 
<Compositeur>D. Castel lo</Compositeur> 
<Compositeur>F. Rognoni</Compositeur> 

</Compositeurs> 
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<Tarif> 

<plein> 15.0 </plein> 
<reductions> 

<jeune>40</jeune> 
<groupe>30</groupe> 
</reductions> 
</Tarif> 



</Concert> 
Concert.xsl 



tml version="1.0" encoding="UTF-16"?> 

;1 stylesheet xmlns :xsl="http://www. w3.org/1999/XSL/Transform" version="l.C 

<xsl:output method='htmr encodings' ISO-8859-1' /> 

<xsl :template match="/"> 
<html> 
<head> 

<title><xsl:value-of select="/Concert/Entete"/X/title> 
</head> 
<body bgcolor="white" text="black"> 

<xsl :apply-templates/> 
</body> 
</html> 
</xsl :template> 



<xsl :template match="Date"> 

<H1 align="center"> Concert du < 
<H4 al ign="center"> <xsl:vali 
<H3 align="center"> <xsl:vah 

</xsl :template> 

<xsl :template match="l_ieu"> 
</xsl :template> 

<xsl : template match="Ensemble"> 
<H2 al ign="center"> Ensemble 
</xsl :template> 



le-of select=". V> </Hl> 
j-of select="/Concert/Lieu"/> </H4> 
;-of select="/Concert/TitreConcert"/X/H3> 



decimal -separator="," 
grouping-separator="." /> 

<xsl :template match="Tarif "> 

<xsl variable name="plein" select=" ./plein"/> 

<xsl :variable name="reducJeune" select-" ./reductions/jeune"/> 

<xsl : variable name="reducGroupe" select=" . /reductions /groupe"/> 



Instruction xshdecimal-format I 



select="$plein - ( $plein * SreducJeune div 100 ) "/> 



name="groupe" 

select="$plein - ( $plein * SreducGroupe div 100 ) "/> 

<P>Tarifs : <br/> 

<xsl :value-of select="format-number( 

Splein, '##,00', 'prix' )"/> Euros <br/> 

<xsl :value-of select="format-number( 

$jeune, '#,00', 'prix' )"/> Euros ( jeunes) ,<br/> 

<xsl :value-of select="format-number( 

Sgroupe, '##,00', 'prix' )"/> Euros (groupes). 
</P> 
</xsl :templ ate> 



</xsl:stylesheet> 



<html> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8 

<title> "Les Concerts d'Anacréon" </title> 
</head> 
<body bgcolor="white" text="black"> 



"Les Concerts d’Anacréor 



<H1 align="c 

<H4 align="c 
<H3 align="c 



""> Concert du Jeudi 17 janvie 
-">Chapelle des Ursules</H4> 
""></H3> 



2002, 20H30</H1> 



D. Castello 
F. Rognoni 

<P>Tarifs : <br>15,C 
</P> 
</body> 
</html> 



Euros <br>9,00 Euros (jei 



),<br>10,50 Euros (groupes). 



Extensions et evolutions 



Extensions 

Les extensions sontdesajouts a la W3C Recommendation XSLT 1.0, leseul standard actuel- 
lement existant (en fevrier 2002). Ces ajouts concernent la definition et I 'implementation 

• denouvellesfonctionsXPath ouXSLT ; 

• ou denouvel les instructions XSLT ; 

• ou denouveaux attributs pour des instructions XSLT existantes. 

Historiquement, ces extensions ont ete d'abord proposees et implementees par les 
concepteurs de processeurs XSLT, puis une initiative de « standardisation » est ensuite 
apparue pour tenter d'harmoniser les extensions les plus communes, et meme pour pro- 
poser aux fournisseurs de processeurs des extensions original es. Cette initiative a pris le 
nom d'EXSLT, et ses travaux sont disponibles sur le site www.exslt.org. Citons aussi la 
XSLTSL (XSLT Standard Library, xsltsl.sourceforge.net) qui estuneunebibliothequede 
modeles nommes « 100% pur XSLT » : ce ne sont done pas a proprement parler des 
extensions, mais certains de ces modeles nommes peuvent parfois recouper certaines 
fonctions proposees par EX SLT. 

Les extensions sont generalement des reponses a la pression des utilisateurs et de la 
concurrence entre fournisseurs de processeurs. Certaines comblent des lacunes du stan- 
dard W 3C X SLT 1.0, d'autres ne comblent aucune lacune proprement dite mais ouvrent 
des perspectives nouvelles de traitement, et d'autres enfin sont des extensions de contort, 
qui simplified beaucoup la programmation, ou qui ameliorent les performances par 
rapport a une solution « 100% pur XSLT ». 

Dans la categorie des extensions comblant des lacunes, on peut citer en tout premier lieu 
la fonctionde conversion d'un RTF en node-set. On peut di re qu' une tel le foncti on est de 
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loin la plus necessaire de toutes les extensions ; mais comme nous en avons deja beau- 
coup parle (voir Temporary SourceTree, page 192 et Operations sur un RTF (XSLT 1.0), 
page 209), il nesera pas utile d'y revenirici dans le detail. 

Une autre lacunetresgenantede XSLT 1.0 est I'impossibilite d'ecrire unefeuille de style 

qui produise en resultat plusieurs documents. C'est pourtant un besoin evident, notam- 
menten HTM L, si I'on veutparexempleproduireun resultat decoupe en plusieurs pages 
differentes, ne serait-ce que pour generer des <f rame> et des <f rameset>, ou un ensemble 
de pages qui se referenced mutuellement (voir par exemple le pattern Pattern n°20 - 
Generation de documents multiples, page 563). 

Enfin une derniere lacune est la faiblesse des possibilites de traitement de dates. XSTL 
2.0 devrait retablir la situation, mais en attendant, on trouvera dans la XSLT Standard 
L i brary (http://xsltsl.sourceforge.net) beaucoup de choses i nteressantes dans le domai ne du 
traitement des dates, meme s'il est impossible de couvrir tous les besoins uniquement 
avec une bibliotheque de modeles nommes : le type date n'existant pas en tant que tel 
dans XSLT 1.0, il est par exemple impossible defaireun tri chronologique sur des dates 
avec I'instruction <xsi :sort>. 

Dans la categorie des extensions ouvrant des perspectives de traitement, citons tout 
d'abord la fonction (redamee par beaucoup d'utilisateurs) devaluation dynamique 
d'une expression XPath donnee sous forme d'une String. Un contexte souvent invoque 
pour justifier son utilisation est celui de la realisation de mises en pages pilotees par 
un document XML auxiliaire, specifiant disposition et contenu dans un format convenu, 
et comportant entre autres des expressions XPath a interpreter dynamiquement 
(voir Pattern n°19 - Construction dynamique de I'agencement d'un tableau HTML, 
page 540). 

Une autre extension, un peu dans lememeordred'idee, estun attributnouveau pour I'ins- 
truction <xsi = can -tempi ate> (voir aussi Pattern n°19 - Construction dynamique de 
I'agencement d'un tableau HTML, page 540), qui indique que I'attribut name est fourni 
sous la forme d'un descripteur de valeur differee d'attribut (chose normal ement interdite) : 
lenom du modeleaappeler estainsi calcule a I'execution, cequi eviteeventuellementun 
<xsi :choose> avec de nombreux cas possibles (un cas par modele a appeler). 

II fautciter aussi I espossibi I itesde connexion a une base dedonneesrelationnelle, autra- 
versd'instructions nouvelles, qui permettent done a une feuillede style derecevoir une 
requete, de la repercuter sur une base de donnees, d'obtenir une reponse, et de la ren- 
voyer decoree en HTM L (par exemple). 

Etpourfinir, il y a I'instruction (generalementnommee<xx:script>) qui permetd'imple- 
menter ses propres extensions en J ava, J avascript, etc., ce qui permet en parti culier d'instal- 
ler sur un processeur (qui fournit cette extension xx:script) une extension propre a un 
autre processeur, pourvu qu'on ait les sources J ava ou J avascript de I 'extension. 

Enfin, dans la categorie des extensions de contort, on trouve beaucoup de choses diffe- 
rentes. Par exemple des instructions permettant de retrouver la programmation habituelle 
avec les bonnes vieilles affections ou la boucle while. On trouve aussi des fonctions 
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Annexe C 

redondantes avec les possi bi I ites natives de XSLT 1.0, maisqui apportentun gain de per- 
formance ou de simplicity appreciable (par exemple unefonction qui renvoie I 'intersec- 
tion de deux node-sets, ou bien une instruction qui permet de faire des regroupements 
sans avoir a les programmer dans le detail). 

Toutes ces extensions sont bien sflr dependantes du processeur utilise : certaines exten- 
sions ne sont pas supportees par certains processeurs, et lorsqu'une meme extension est 
supportee par plusieurs processeurs, les denominations sont generalement differentes 
(nodeseto, node-seto, nodeSeto, etc.), et les domaines nominaux a declarer pour 
prefixer ces extensions sont a coup sflr differents. Sauf si ... 

... Sauf si c'est une extension disponiblesur EXSLT, et que le processeur utilise la four- 
nit. Auquel cas, la denomination et ledomaine nominal sont definis par EXSLT, et non 
par lefournisseurdu processeur, cequi garantitla portabilite. A utrement, si I'on veutune 
feui I lede style uti I isant des extensions et compatible avec un ensemble de processeurs, il 
n'y a guered'autre solution que demaintenir differentes versions decette feui I lede style, 
cequi n'est pas une situation tres enviable, il fautbien I'avouer. 

Pour une liste precise et a jour des extensions disponibles avec chaque processeur, il 
fautse reporter a sa documentation ; par exemple : http://saxon.sourceforge.net/ ou http:// 
xml.apache.org/xalan-j/. 

Evolutions : XSLT 2.0 etXPath 2.0 

Si les extensions sont le fait des concepteurs de processeurs XSLT, les evolutions, el les, 
sont dues aux travaux du XSL Working Group du W3C, dont le but est de les proposer, 
puis de les stabiliser sous la forme d'une Final Recommendation. 

La seule recommandation finale pour X SLT, a la date d'ecriture de ce livre (fevrier 2002), 
est celle du 16 novembre 1999 : c'est le standard XSLT 1.0. Bien sflr, des le debut des 
extensions ont commence a apparaitre, certaines fort pertinentes, et un groupe de travail 
s'est constitue pour prendre en compte le mieux possible certaines de ces extensions, et 
faire evoluer XSLT en 1.1. Mais les changements apportes ou proposes par la derniere 
version du Working Draft XSLT 1.1 ( 24 aoflt 2001) etaienttropimportants pour que cette 
evolution puisse passer pour mi neure. A ussi cette version a-t-elleete abandonnee en tant que 
telle, et les propositions qu'elleavancait ontete incorporees au chantier de la version 2.0 du 
langage. Deux Working Drafts (XSLT 2.0 etXPath 2.0) sont parusle 20 decembre 2001, 
qui ouvrentde nouvelles perspectives sur ces langages. Bien sflr, rien n'est encore joue, 
et des evolutions importantes dans un sens ou dans I 'autre peuvent etre encore possibles 
d'ici la parution d'une Final Recommendation. On peut tout de meme tenter une breve 
synthese de ces evolutions. 

Perspectives pour XSLT 2.0 

Une premiere evolution, qu'on peut penser relativement peu sujette a etre remise en 
cause, concerne I a redaction del a specification du langage. La version XSLT 1.0 etait un 
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peu spartiate par bien des cotes, et beaucoup trap concise sur certains points, ce qui ren- 
dait la lecture assez ardue. D 'autre part, certains termes, comme template, etaient trap 
charges de sens differents suivant les contextes. U n effort a done ete fait, pour repenser la 
redaction, la completer, la rendre plus facile a lire et a comprendre, et pour proposer de 
nouveaux termes (par exemple content constructor, et non plus template) pour designer 
un model ede transformation. A noter que dans eel ivre, cet effort a ete anticipe, puisque 
nous avions choisi ce terme de module de transformation bien avant que ne paraisse le 
WDXSLT2.0. 

Les autres evolutions concernent le langage proprement dit; certaines sont mineures, 
d'autres sont majeures. Nous listerons certaines des evolutions majeures, pour donner 
une idee de la direction queva prendre XSLT. 

Mai fames, les RTF (Result Tree Fragment, voir Temporary Source Tree, page 192) ont 
ete repudies, etcommeXSLT 1.1 leproposait, un Temporary Source Tree accroche a une 
variable est vu comme un objetde type node-set. Done tout ce qui aeteexpliquedansla 
section referenced ci-dessus est maintenu. 

Les programmes XSLT pourront creer plusieurs documents resultats, avec la nouvelle 
instruction <xsi :resuit-document>,qui fonctionne d'une facon largementinspireedece 
queproposait<xsi :document> deXSLT 1.1. 

Une instruction <xsi :for-each-group>, allant de pair avec une nouvelle fonction cur- 
rent-groupo, a ete introduite pour faciliter les regroupements (voir Pattern n°14 - 
Regroupements, page 474. 

II sera possible d'ecrire non plus des modeles nommes, mais de veritables fonctions, que 
I'on pourra appeler dans des expressions XPath sans etre oblige d'utiliser le tank 

<xsl : call -tempi ate>. Pour Cda, I eS instructions <xsl :function> et <xsl :result> Ont 

ete proposees. 

On peut done resumer tout ceci est disant que globalement, il sera a I'avenir moins ardu 
de programmer en XSLT, notamment grace a I 'introduction de la notion de fonction, et 
decellederegroupement. 

Perspectives pour XPath 2.0 

En cequi concerne XPath, il s'agit plus d'une revolution que d'une simple evolution. 
En effet, un nouveau langage, XQuery 1.0, a ete defini, et sa definition repose sur 
XPath 2.0. Ce qui veut dire que les groupes de travail XSL et XM L Query ont joint 
leurs forces pour definir de facon commune le langage XPath 2.0. Autant dire que 
XPath prend une nouvelle orientation, afin deconvenir a lafois aux besoinsdeXSLT 
etde XQuery. 

Pour comprendre cette evolution, il faut savoir que XQuery est un langage XM L de 
requetes sous forme d'expressions ; ces expressions obeissent a une grammaire qui est un 
sur-ensemblede XPath 2.0. D'une certainemaniere, on peut dire que les langagesXSLT 
et XQuery sont a la fois complementaires et redondants suivant la facon dont on les 
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analyse. Complementaires parceque ledomained'XSLT est plutot celui de la transfor- 
mation que eel ui delarequete; redondants parceque XSLT et X Query fournissenttous 
les deux le moyen d'exprimer des recherches dans un document XML arbitral rement 
complexe, maisanouveau complementaires, memedanscedomaine, parce que X Query 
est clai rement plus simple a utiliser que XSLT pour exprimer des requetes complexes, et 
surtout est concu pour favoriser une optimisation tres poussee de ces requetes, de la 
meme facon que SQL a ete a I'origine d'optimisations tres fines des moteurs de bases de 
donnees relationnelles. 

Les evolutions d'XPath portent d'abord sur le modele de donnees utilise : desormais, 
XPath repose sur les types simples definis par les Schemas XML (www.w3.org/TR/ 
xmlschema-2) ; d'autre part, XPath offre maintenant la notion de sequence, qui est une 
liste ordonnee de valeurs, et qui vient done en complement de la notion d'arbre, qui etait 
jusqu'a present la seule structure de donnees uti Usable. 

XPath 2.0 introduitde plus des extensions aux constructions existantes, etdesoperateurs 
nouveaux. Par exemple, la notion d'etape de localisation a ete etendue a celle d'etape 
generalised, qui peut faire intervenir une expression XPath, ce qui permet d'ecrire des 
chosescomme: 

partie/(chapitre|annexe)/paragraphe 

ou comme 

document ("t rue. xml ")/ key ("...", "...") 

Des expressions nouvelles apparaissent, notamment I 'expression for/return (qui 
retourne une sequence de valeurs), I 'expression if (qui retourneunevaleur parmi deux 
possibles, suivant une condition), et I'assertion booleenne quantified some/every/ 

satifies. 
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for $a in distinct-values(//author) 
return ( 

$a, 

for $b in //book[$b/aut 

Expression if 

if (@pseudonyme) 
then ©pseudonyme 
else @nom 

Assertion quantifiee 

some $emp in //employee satisfies 
($emp/bonus > 0.25 * $emp/salary) 
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Enfin de nouveaux operateurs sont proposes, == pour tester I 'identite de deux nceuds, et « 
pour tester I'ordred'apparition dedeux nceuds au sein d'un meme document. Exemples : 

Exemples: 

Test d' identite 

//book[@isbn = '12345'] == //author[@name='dudule' ]/book[l] 

Test d'anteriorite (ordre de lecture du document) 

//book[@isbn = '12345'] « //book[@isbn = '54321'] 

On voit done que X Path change completement de statut : avant e'etait un humble servi- 
teur deXSLT, desormais il est le socle sur lequel sera bati le langageX Query (et dans 
unemoindremesureXSLT). Etcommeil est probable qu'a I 'avenir il nesera plus suffi- 
santdeconnaitreuniquementXSLT, car certaines applications devrontuti User conjointe- 
ment X SLT et X Query pour etre vrai ment performantes, on peut penser que I 'i mportance 
de X Path ne fera que crottre. 



Reference des instructions XSLT 



Notations 

Les mots en italique sont des symboles terminaux (c'est-a-dire non definis dans les 
regies syntaxiques). 

Les accolades { } f ont parti e del a syntaxedecri vant certains attributs. Elles denotent la 
possibilite d'utiliser desAVT (Attribute Value Template), ou descripteur de valeur diffe- 

reed'attribut. Laou il n'y a pasd'accolades, c'estquel'emploi de descripteur de valeur 
differee d'attribut est interdit. 

Certaines notations propres aux DTD sont reprises ici : 

• x* signifie que x peut apparaitre 0, 1 ou plusieurs fois ; 

• x? signifie que x peut apparaitre ou 1 fois ; 

• x+ signifie que x peut apparaitre 1 ou plusieurs fois ; 

• x | y signifie que x peut apparaitre ou que y peut apparaitre; 

• "X" signifie que x doit apparaitre I itteralement. 

Symboles terminaux 

qname 

Lesymboleqname veut dire Quailed Name. Un nom qualifie estun nom XM L avec ou 
sansprefixe, comme par exemple true ou fo:biock. 

ncname 

Lesymbolencname veut dire Non Colonized Name. C'estun nom XML sansprefixe. 
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qname-but-not-ncname 

Lesymboleqname-but-not-ncname estun nom XM L obligatoirementprefixe. 



prefix 

U n prefix est un ncname qui sert de prefixe dans un qname. 



Le symbole uri-reference veut dire U nique Resource Identifier. C'est une generalisation 
de la notion d'URL, qui pour I 'instant n'est pas encore vraiment stabilised. On peutdonc 
considererqueURI etURL sont synonymes. 

pattern 

Le symbole pattern veut dire ici motif. 

expression 

Une expression veut dire une expression XPath quelconque. 

node-set-expression 

Une node-set-expression est une expression XPath qui renvoieun node-set. 

boolean-expression 

U ne boolean-expression est une expression X Path qui renvoie une valeur booleenne. 

number-expression 

U ne number-expression est une expression X Path qui renvoie nombre. 

string-expression 

Une string-expression est une expression XPath qui renvoie une String. 

nm token 

Un nmtoken (NameToken) est une suite de caracteres val ides pour former un nom XML. 

nametest-tokens 

U n nametest-tokens est une suite de nametest separes par des espaces blancs. U n name- 
test est un determinant, intervenant dans une etape de localisationX Path. Un nametest 
peutetreun qname, ou uneetoile, ou uneetoileprefixee(par exemple "to:*"). 

ncname-tokens 

U n ncname-tokens est une suite de ncname separes par des espaces blancs. 
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Regies syntaxiques 

Instruction xsl :apply-imports 

<xsl :apply-imports /> 

Instruction xsl :apply-templates 

si :apply-templates 
select = node-set-expression 
mode = qname) 

<!-- Contenu : (xsl:sort | xsl :with-param)* --> 
</xsl :apply-templates> 

Instruction xsl :attribute 

<xsl :attribute 

name = ( qname } 

namespace = { uri-reference }> 

<!-- Contenu : modele de transformation --> 

</xsl: attribute) 

Instruction de premier niveau xsl :attribute-set 

<xsl: attribute-set 
name = qname 

use-attribute-sets = qnames> 
<!-- Contenu : xsl :attribute*--> 

</xsl :attribute-set> 

Instruction xsl : call -tempi ate 

<xsl :cal 1 -template 

name = qname> 

<!-- Contenu : xsl :with-param*--> 
</xsl: call -template) 

Instruction xsl:choose 

<xsl :choose> 

<!-- Contenu : (xsl:when+, xsl :otherwise?) --> 
I </xsl :choose> 

Instruction xsl :comment 

<xsl : comment) 

<!-- Contenu : modele de transformation --> 
</xsl : comment) 

Instruction xsl :copy 

<xsl :copy 

use-attribute-sets = qnames) 

<!-- Contenu : modele de transformation --> 

</xsl:Copy) 
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Instruction xsl:copy-of 

<xsl :copy-of 

select = expression /> 

Instruction de premier niveau xsl : decimal -format 

<xsl :decimal -format 
name = qname 

decimal -separator = char 
grouping-separator = char 
infinity = string 

NaN = string 
percent = char 
per-mille = char 
zero-digit = char 
digit = char 
pattern-separator = char /> 

Instruction xsltelement 

<xsl :element 

name = { qname } 

namespace = { uri -reference } 

use-attribute-sets = qnames> 

<!-- Contenu : modele de transformation --> 
</xsl :element> 

Instruction xs1:fa!1back 

<xsl :fal lback> 



Instruction xsl :for-each 

<xsl:for-each 

select = node-set-expression> 

<!-- Contenu : (xsl:sort*. modele de transformatiot 
</xsl:for-each> 

Instruction xs1:if 

<xsl:if 

test = boolean-expression> 

<!-- Contenu : modele de transformation --> 
</xsl:if> 

Instruction de premier niveau xsltimport 



<xsl : import 

href = uri -reference /> 
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Instruction de premier niveau xsl: include 

<xsl :incl ude 

href = uri-reference /> 

Instruction de premier niveau xsl: key 

<xsl :key 

match = pattern 
use = expression /> 



Instruction xsl :message 

<xsl :message 



terminate = "yes" | "no"> 
<!-- Contenu : modele de transformation - 
</xsl :message> 

Instruction de premier niveau xsl :namespac€ 

<xsl :namespace-alias 

stylesheet-prefix = prefix | "#default" 
result-prefix = prefix | "#default" /> 

Instruction xsl:number 

<xsl :number 

level = "single" | "multiple" | "any" 

count = pattern 

from = pattern 

value = number-expression 

format = { string } 

lang = { nmtoken } 

letter-value = ( "alphabetic" | "traditic 

grouping-separator = { char } 

grouping-size = { number } /> 

Partie d'instruction xsl otherwise 

<xsl :otherwise> 



Instruction de premier niveau xsl:output 

<xsl :output 

method = "xml" | "html" [ "text" | qname-but-not-n 

version = nmtoken 

encoding = string 

omit-xml-declaration = "yes" | "no" 

standalone = "yes" | "no" 

doctype-public = string 

doctype-system = string 

cdata-section-elements = qnames 
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indent = "yes" | "no" 
media-type = string /> 

Instruction de premier niveau ou partie d'instruction xsl:par; 

<xsl :param 

select = expression> 

<!-- Contenu : modele de transformation --> 
</xsl :param> 

Instruction de premier niveau xsl :preserve-space 



Instruction xsl :processing-instruction 

<xsl :processing-instruction 

I name = { ncname }> 

<!-- Contenu : modele de transformation --> 
</xsl :processing-instruction> 

Partie d'instruction xsl:sort 

<xsl:sort 

select = string-expression 

lang = { nmtoken } 

data-type = { "text" | "number" | qname-but-not-ncname} 

order = { "ascending" | "descending" } 

case-order = { "upper-first" | "lower-first" } /> 

Instruction de premier niveau xsl :strip-space 

<xsl :strip-space 

elements = nametest-tokens /> 

Racine du document XSLT xsl : stylesheet 

<xsl :stylesheet 

id = id 

extension-element-prefixes = ncname-tokens 

exclude-result-prefixes = ncname-tokens 

version = number> 

<!-- Contenu : (xsl rimport*, Instructions de premier niv 
</xsl: stylesheet) 

Instruction de premier niveau xsl: tempi ate 

<xsl :template 

match = pattern 

name = qname 

priority = number 

mode = qname> 

<!-- Contenu : (xsl :param*, modele de transformation) -- 
</xsl :templ ate> 
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Instruction xsl:text 

<xsl :text 

disable-output-escaping = "yes" | "no"> 

<!-- Contenu : #PCDATA --> 
</xsl:text> 

Racine du document XSLT xsl : transform 

<xsl: transform 
id = id 

extension-element-prefixes = ncname-tokens 
excl ude-result-prefixes = ncname-tokens 

<!-- Contenu : (xsl :import*, top-level -elements) --> 
</xsl :transform> 

Instruction xs1:value-of 

<xsl :value-of 

select = string-expression 

disable-output-escaping = "yes" | "no" /> 

Instruction de premier niveau ou instruction xslivariable 

<xsl variable 



select = expression> 

<!-- Contenu : modele de transformation --> 

</xsl:variable> 

Partie d'instruction xsl : when 

<xsl :when 

test = boolean-expression> 

<!-- Contenu : modele de transformation --> 

</xsl :when> 

Partie d'instruction xsl :with-param 

<xsl :with-param 

select = expression> 

<!-- Contenu : modele de transformation --> 

</xsl :with-param> 
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Fonctions XPath 

Note 

Cette annexe estune adaptation de la traduction frangaise de la Recommandation XPath 1.0 du 16 novembre 
1999, realisee par j ean-J acques Thomasson etYves Bazin. Elle est disponible a I'adresse http://xmlfr.org/w3c/ 
TR/xpath. Les modifications consistent essentiellementen une homogeneisation de vocabulaire, de locutions et 
de tournures avec le reste du livre. Quelques remarques en marge du texte ontete ajoutees ga et la, pour eclai- 
rer la comprehension. 

Cette section decrit les fonctions que les implementations de XPath doivent toujours 
inclure dans leursbibliothequesde fonctions uti Usees pour I 'interpretation des expressions. 
Chaquefonction dela bibliotheque est specifiee en utilisant unefonction prototype, qui 
donne le type retourne, le nom de la fonction et le type des arguments. Si un type d'argu- 
ment est suivi d'un point d'interrogation, cela signifle que cet argument est optionnel ; 
sinon, I 'argument est requis. 

Fonctions de manipulation de node-sets 

number last() 

La fonction last retourne un nombre egal au nombre total de nceuds memorise dans le 

contexte devaluation del 'expression (voir Contexte d 'evaluation d'un predicat, page 57). 
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number position^) 

Lafonction position retourneun nombreegal a I'indice de proximite memorise dans le 

contexte devaluation del 'expression (voir Contexte devaluation d'un predicat, page 57). 

number count( node-set ) 

La fonction count retourne le nombre de nceuds du node-set passe en argument. 

node-set id( object ) 

La fonction id selectionne les elements par leur identifiant unique. Quand I'argument 
de la fonction id est du type « node-set », alors le resultat est I'ensembledes resultats de 
I'applicationde la fonction id a la valeur textuelle (string-value) dechacun des nceuds du 
node-set passe en argument. Quand I'argument de la fonction id est d'un autre type, 
celui-la est converti en une chaine de caracteres comme par un appel a la fonction string. 
La chaine de caracteres est transformed en une serie d'unites lexicales separees par des 
espaces blancs. Le resultat est un node-set contenant les elements du meme document 
quelenceud contexte et qui ontun identifiant unique egal a I'unequelconque des unites 
lexicales de la serie. 

• idctruc") selectionne I'element qui a comme identifiant unique true ; 

• id("truc")/child: :para[posi ti on( )=5] Selectionne le CinquielTie enfant para de 

I'element qui a comme identifiant unique true. 

string local-name( node-set ? ) 

Lafonction local-name retourne la parti e locale du nom du nceud du node-set passe en 
argument qui est le premier dans I'ordre de lecture du document. Si le node-set passe 
en argument est vide ou que le premier nceud n'a pas de nom, la fonction retourne une 
chaine de caracteres vide. Si I'argument est omis, la valeur par defaut utilisee par la fonction 
est un node-set reduit au seul nceud contexte. 

string namespace-uri( node-set ? ) 

Lafonction namespace-uri retourne I'URI correspondantaudomaine nominal du nceud 
du node-set passe en argument qui est le premier dans I'ordre de lecture du document. Si 
le node-set passe en argument est vide, ou si le premier noeud n'a pas de nom, ou n'a pas 
dedomaine nominal, une chaine vide est retournee. Si I'argument est omis, e'est comme 
si on avait transmis un node-set ne contenant que le nceud contexte. 

Note 

La chaine retournee par la fonction namespace-uri est vide sauf pour les nceuds de type el ement et attri bute. 

string name( node-set ? ) 

Lafonction name retourne une chaine contenant un nom qualifie representantlenom du 
nceud du node- set passe en argument qui est le premier dans I'ordre de lecture du document. 
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Ce nom qualifie tient compte de la declaration du domaine nominal en vigueur sur le 
nceud en question. 

General ement, le nom retourne est le meme que le nom qualifie apparaissant dans le source 
X M L . M ais il peut y a voir des cas ou le nom retourne n'emploie pas le meme prefixe que 
dans le source XM L ; meme dans ce cas, il reste encore certain que le domaine nominal 
associe a ce prefixe est le meme que celui declare pour le nceud considers dans le source 
XML. Si lesourceXML utilise pi usieurs prefixes pour le meme domaine nominal, la fonc- 
tion nameo peuttresbien normaliser la situation en n'en n'utilisant qu'un seul. 

Si le node-set passe en argument est vide ou que le premier nceud n'a pas de nom, une 
chaine vide est retournee. Si I 'argument est omis, c'est comme si on avait transmis un 
node- set ne contenant que le nceud contexte. 

Note 

La chaine retournee par la fonction name est identique a celle retournee par la fonction l ocal -name, excepte pour 
les nceudS de type element et attribute. 

Fonctions manipulant des chafnes de caracteres 

string string( object ? ) 

La fonction string convertit un objet en chaine de caracteres selon les regies indiquees 
ci-dessous. 

U n node-set est converti en chaine de caracteres en retournant la valeur textuelle du pre- 
mier nceud du node-set dans I'ordrede lecture du document. Si le node-set est vide, une 
chaine vide est retournee. 
U n nombre est converti en chaine comme suit : 

• N aN est converti en la chaine de caracteres NaN ; 

• lezero positif est converti en la chaine o (caracterezero) ; 

• I e zero negatif est converti en la chaine o (caractere zero) ; 

• I'infini positif est converti en la chaine infinity ; 

• I'infini negatif est converti en la chaine -infinity ; 

• si le nombre est un entier, il est represents sous forme decimale comme un nombre 
(Number) sans point decimal et sans chiffre apres la virgule, preceded'un signemoins 
(-) si le nombre est negatif ; 

• sinon, le nombre est represents sous la forme d'un Nombre (Number) ayanttoujours 
au moins un chiffre avant et apres le point decimal, precede du signe moins (-) si le 
nombre est negatif ; si le nombre est inferieur a 1 en valeur absolue, il n'y a qu'un seul 
avant le point decimal. Enfin, au dela du premier chiffre requis apres le point deci- 
mal, il doit y avoir le nombre de chiffres necessaire et suffisant pour differencier sans 
ambiguite le nombre detoutes les autres valeursnumeriquesdu standard IEEE 754. 
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La valeurbooleenne false estconvertieen la chaine de caracteres false. La valeur boo- 
leenne true est convertie en la chaine de caracteres true. 

Tout objet d'un type different des quatre types de base est converti en chaine de caracte- 
res selon une regie propre au type en question. 

Si I'argument est omis, c'est comme si on avait transmis un node-set ne contenant que le 
nceud contexte. 



Note 

La fonction string( ) n'est pas faite pour formater des nombres en chaines de caracteres pour les besoins 
d'affichage ou de presentation aux utilisateurs. La fonction format-number et I'element xsi :number de XSLT 
sontlapourga. 

string concat( string , string , string *) 

La fonction concat retourne le resultat de la concatenation des arguments. 

boolean starts-with( string , string ) 

L a fonction starts-with retourne la valeur booleenne true si la premiere chaine de carac- 
teres passee en argument commence par la chaine de caracteres passee en deuxieme 
argument; sinon, cette fonction retourne la valeur false . 

boolean contains( string , string ) 

La fonction contains retourne true si la premiere chaine de caracteres passee en argu- 
ment contient la chaine de caracteres passee en deuxieme argument ; sinon, retourne la 
valeur false . 

string substring-before( string , string ) 

La fonction substring-before(sl,s2) retourne la sous-chaine de si qui precede la pre- 
miere occurrence des2 dans si, ou une chaine vide si si ne contient pas s2. Parexemple, 

substring-before( "1999/04/01","/") retoume 1999. 

string substring-after( string , string ) 

La fonction substring-after(sl,s2) retourne la sous-chaine de si qui suit la premiere 

occurrence de s2 dans si, ou une chaine vide si le si ne contient pas s2. Par exemple, 

substring-after("1999/04/01"."/") retourne 04/01, et substri ng-after( "1999/04/ 

oi", "19") retourne 99/04/01. 

string substring( string , number , number ? ) 

La fonction substring(str, indexDebut, Ig) retourne la sous-chaine de str commencant 

a la position indexDebut et de longueur lg. Par exemple, substring("12345",2,3) 

retourne "234". Si le troisieme argument n'est pas specifie, la fonction retourne la sous- 
chaine allant de la position de depart spedfiee par indexDebut jusqu'a la fin de str. Par 

exemple, substring("12345",2) retourne "2345". 
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Plus precisement, chaque caractere de la chainea une position numerique : celledu pre- 
mier caractere est 1, celle du deuxieme est 2, etc. 

Note 

Ceci differe dejava etECMAScript, dans lesquels les methodes string, substring considered que la position 
du premier caractere est 0. 

L a sous-chaine retournee contient les caracteres dont la position est superieure ou egale a 
la valeur arrondiede indexDebut et (si le troisieme argument ig est specifie) inferieure 
a la somme des valeurs arrondies de indexDebut et ig ; les comparaisons et I'addition 
utilisees ci-dessus doivent suivre les regies du standard IEEE 754 ; I'arrondi est calcule 
comme par un appel a la fonction round. 

Les exemples suivants illustrent differents cas de figures courants : 

• substring("12345", 1.5, 2.6) retoume "234" ; 

• substring("12345", 0, 3) retOUme "12" ; 

• substring("12345", div 0. 3) retOUme "" J 

• substring("12345", 1, div OUetOUme"" ) 

• substring("12345", -42, 1 div 0) retOUme "12345" ; 

• substring("12345", -1 div 0, 1 div 0) retOUme " ". 

number string-length( string ? ) 

La fonction string-length retourne le nombre de caracteres de la chaine. Si I'argument 

est omis, la valeur retournee est egale a la longueur de la valeur textuelle du noeud 

contexte. 

string normalize-space( string?) 

La fonction normalize-space retourne la chaine de caracteres passee en argument apres 
y avoir normalise les espaces blancs : suppression des espaces blancs en debut et fin et 
remplacement des sequences d'espaces blancs successifs par un seul caractere blanc. 
Si I'argument est omis, la fonction retourne la chaine obtenue en ayant utilise comme 
argument la valeur textuelle du nceud contexte. 

string translate( string , string , string ) 

L a fonction translate retourne la premiere chaine de caracteres passee en argument dans 
laquelle les occurrences des caracteres de la deuxieme chaine sont remplacees par les 
caracteres correspondant aux memes positions de la troisieme chaine. Par exemple, 
transiate("bar","abc","ABC") retourne la chaine BAr . Si I'un des caracteres du 
deuxieme argument n'a pas de position correspondante dans le troisieme (parce que 
le deuxieme argument est plus long que le troisieme), alors les occurrences de ce carac- 
tere sont supprimeesdu premier argument. Par exemple, transiate("--aaa--"."abc-". 
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"ABC") retourne "AAA". Si un caractere apparait plus d'unefois dans la deuxiemechaine, 
alors c'est la premiere occurrence de ce caractere qui determine la regie de transforma- 
tion. Si la chaine passee en troisieme argument est plus longue que la deuxieme, alors, les 
caracteres en trop sont ignores. 



La fonction translate n'est pas suffisante pour les changements de casse dans toutes les langues. Une future 
version de XPath fournira des fonctions additionnelles a cette fin. 



Fonctions Booleennes 

boolean boolean( object ) 

La fonction boolean convertitses arguments en booleensselon les regies suivantes: 

• un nombre est vrai (true) si etseulements'il n'est ni unzero positif ou negatif, ni un 
NaN ; 

• un node-set est vrai (true) si etseulements'il n'est pas vide; 

• une chaine de caracteres est vraie (true) si etseulementsi sa longueur n'est pas nulle; 

U n objet d'un type autre que les quatre types de base est converti selon des regies speci- 
riques a chaque type. 

boolean not( boolean ) 

La fonction not retourne la negation logique de la valeurdu booleen passeen argument: 
vrai (true) si I 'argument est faux et vice-versa. 

boolean true() 

La fonction true() retourne true. 

boolean false() 

La fonction false() retourne false. 

boolean lang( string ) 

La fonction lang retourne true si et seulement si la langue associee au nceud contexte 
correspond a la langue passee en argument de la fonction, ou en est une variante locale. 
La langue du nceud contexte est determi nee par la valeur del'attributxmi :iang du nceud 
contexte, ou, si celui-ci n'a pas cet attribut, par la valeur de I'attribut xmi :iang du plus 
proche ancetre du nceud contexte ayant cet attribut. Si aucun n'est trouve, la fonction 
lang retourne la valeur false. Si un tel attribut existe, alors la fonction lang retourne la 
valeur true si la valeur del 'attribut est egale a cell e passee en argument (les differences 
de casse etantignorees), ou s'il existeun certain suffixecommencantpar - desorteque la 
valeur de I 'attribut soit egale a I 'argument si on ignore ce suffixe et la casse. Par exemple, 
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langCen") retourne la valeur true si le noeud contexte est I'un des quatre elements 
<para> suivants : 

• <para xml : 1 ang="en"/> ; 

• <div xml :lang="en"Xpara/X/div> ; 

• <para xml :lang="EN"/> J 

• <para xml : 1 ang="en-us"/>. 

Fonctions numeriques 

number number( object ? ) 

Lafonction number convertiten nombreson argument passe selon les regies indiquees 

ci-dessous. 

• Une chaine de caracteres qui est composee d'espaces blancs (optionnels) suivis du 
signemoins(-) suivi d'un nombre (Number) suivi d'espaces blancs est convertie en un 
nombrele plus proche possible (selon la regie d'arrondi au plus proche del IEEE 754) 
du nombre IEEE 754 le pi us proche possible de la valeur mathematiqueexacte repre- 
sentee par la chaine ; toute autre chaine est convertie en NaN . 

• Les booleens vrais ( true ) sont convertis en 1 ; les booleens faux ( false ) sont 
convertisen 0. 

• U n node-set est d'abord converti en chaine de caracteres comme par I'effet d'un appel 
a la fonction string et cette chaine est ensuite considered comme argument de la fonc- 
tion number. 

• U n objet de type different des quatre types de base est converti en un nombre sel on des 
regies dependantes du type de I 'objet. 

Si I'argument est omis, la valeur retournee par defaut est celle qui auraitete obtenue en 
considerant un node-set contenant le seul noeud contexte. 

Note 

La fonction number ne doit pas etre utilisee pour convertir des donnees numeriques se trouvant dans un 
elementd'un documentXML sauf si Pelementen question estd'un type permettant de representees donnees 
numeriques dans un format neutre (qui serait typiquement transforme dans un format specifique pour etre 
presentees a un utilisateur). De plus, la fonction number ne peut etre utilisee que si le format neutre utilise par 
Pelement est coherent avec la syntaxe XPath definie pour les nombres (Number). 

number sum( node-set ) 

Lafonction sum retourne la somme, pour tous les nceudsdu node-set passe en argument, 
des resultatsde la conversion en nombre des valeurstextuel les (string-values) dechacun 
decesnceuds. 
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number floor( number) 

La fonction floor retourne le plus grand (du cote de I'infini positif) nombre entier infe- 

rieura I'argument. 

number ceiling( number ) 

La fonction ceiling retourne le plus petit (du cote de I'infini negatif) nombre entier qui ne 

soit pas inferieur a I 'argument. 

number round( number ) 

L a fonction arrondi ( round) retourne I e nombre entier I e pi us proche del 'argument. S'il 
y a deux nombres possibles, alorscelui des deux qui est le plus proche de I'infini positif 
est retourne. Si I'argument est NaN, alors NaN est retourne. Si I'argument est I'infini 
positif, alors I'infini positif est retourne. Si I'argument est I'infini negatif, alors I'infini 
negatif est retourne. Si I'argument est I e zero positif, alors le zero positif est retourne. Si 
I'argument est le zero negatif, alors le zero negatif est retourne. Si I'argument est infe- 
rieur a zero, maisplussuperieurouegal a -0.5, alors le zero negatif est retourne. 

Note 

Pour les deux derniers cas, le resultat de I'appel de la fonction round ne donne pas le meme resultat qu'en addi- 
tionnant 0.5 au resultat de la fonction floor . 



Fonctions XSLT 

Fonctions de manipulation de node-sets 

node-set document^ object , node-set ? ) 

La fonction documento permet d'acceder aux documents XML autres que le document 
source principal. 

Lorsque la fonction documento a exactement un argument et que cet argument est un 
node-set alors, le resultat est I'union, pour chaque nceud du node-set recu en argument, 
du resultat de I 'execution de la fonction documento avec comme premier argument la 
valeur textuelle du nceud, et comme deuxieme argument un node-set dont I 'unique ele- 
ment est I e nceud lui-meme. Lorsque la fonction documento a deux arguments et que I e 
premier argument est un node-set, alors le resultat est la reunion, pour chaque nceud du 
node-set recu en argument, du resultat de I 'execution de la fonction documento avec 
comme premier argument la valeur textuelle du nceud et, comme deuxieme argument, le 
deuxieme argument passe a la fonction documento. 

Si le premier argument de la fonction document n'est pas un node-set alors il sera 
converti en une chaine de caracteres comme par appel a la fonction stringo. Cette 
chaine de caracteres est traitee comme une reference a un URI ; la ressource identified 
par I'URI est extraite. Les donnees resultant de la fonction d'extraction sont analysees 
comme un document XML et un arbre est construit en concordance avec le modele de 
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donnees (voir Module arborescent d'un document XML vu par XPath, page 30). Si 
I 'extraction dela ressourcesesoldepar uneerreur, alors leprocesseurXSLT peut signa- 
ler I 'erreur; s'il nele fait pas, il doit retourner un node-set vide. Le genre d' erreur pou- 
vant se produire a I 'extraction, serait que le processeur X SLT ne connaisse pas la syntaxe 
uti I i see pour I'URI. Un processeur XSLT n'est pas cense connaitre toutes les syntaxes 
particulieres d'URI. Les syntaxes d'UR I acceptees par un processeur XSLT doiventetre 
clairement indiquees dans sa documentation. 

En marge de ce texte 

Un identificateur de fragment est un identificateur qui designe une partie d'une ressource. Par ex., pour I'URL 
http://www.truc.Org/index.html#ici, I'identificateur defragment est ici. 

Si la reference a I'URI ne contient pas d'identificateur de fragment, alors la fonction 
retourne le node-set contenant uniquement le nceud racine du document. Si la reference a 
I'URI contient un identificateur de fragment, alors la fonction retourne un node-set 
contenant I es nceuds de I ' arbre i denti fies par I ' i denti ficateur de fragment de I a reference a 
I'URI. La semantique de I'identificateur de fragment depend du type de media (type 
MIME) du resultat de I'extraction de I'URI. Si lors du traitement de I'identificateur de 
fragment, une erreur se produit, le processeur XSLT peut signaler cette erreur, ou bien 
retourner un ensemblevidede nceuds. Exemplesd'erreurs possibles : 

• L'identificateur du fragment fait reference a quelque chose qui ne peut etre represents 
par un node-set XSLT (comme une sous-chaine de caracteres a I'interieur d'un nceud 
texte). 

• Le processeur XSLT ne connait pas la facon de traiter les i denti ficateurs de fragment 
pour le type MIME du resultat dela recuperation. Un processeur XSLT n'est pas sup- 
pose pouvoir traiter tous les types MIME particuliers. La documentation de chaque 
processeur X SLT doit indiquer quels sont les types MIME acceptes pour le traitement 
des i denti ficateurs de fragments. 

L es donnees resultant de I 'action d'extraction sont analysees comme tout autre document 
XML sans tenircomptedu type MIME du resultat del 'extraction ; si letype MIME prin- 
cipal est text, alors il est analyse comme si letype MIME etaittext/xml ; autrement, il 
est analyse comme si letype MIME etait application/xml. 

Note 

Puisqu'iln'ya pas de type MIME principal xml, les donnees avec un type MIME autre que text/xmi ou appii- 
cation/xmi peuventtres bien etre quand meme des donnees XML. 

La reference a I'URI peut etre relative. L'URI de base (voir Remarque ci-dessous) du 
nceud qui apparait le premier dans le document et qui appartientau node-set dudeuxieme 
argument est utilise comme U Rl de base pour resoudre les U Rl relatifs et les transformer 
enURI absolus. Lorsque ledeuxieme argument est omis, il est par defaut egal al'element 
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XSLT (lenceud del'arbreXM L du programme XSLT) qui contient I 'expression ou figure 
I'appel a la fonction documento. Notezqu'une reference a un URI de tai 1 1 e null e est une 
reference au document dont I'URI qui lui est relatif est en cours de resolution ; ainsi 
documentc) fait reference au nceud racine de la feuille de style elle-meme; I'arbre 
XML de la feui lie de style est exactement le meme que eel ui qu'on obtiendrait en prenant 
cette feuille de style comme document source initial. 

URI de base (remarque en marge de ce texte) 

A chaque noeud est associe un URI qu'on appelle son URI de base, qui est utilise pour resoudre des valeurs 
d'attributs qui represententdes URI relatifs (e'est-a-dire pour determiner I'URI absolu connaissant I'URI relatif), 
suivant un principe identique a celui de la construction d'un chemin absolu designant un fichier, connaissant un 
chemin relatif etun repertoire de base qui sertde reference pour revaluation du chemin relatif). Si un elementou 
une processing-instruction apparaitdans une entite externe, alors son URI de base est I'URI de I'entite externe ; 
autrement, I'URI de base estl'URI de base du document. L'URI de base du nceud racine de I'arbre XML est I'URI 
de I'entite document. L'URI de base d'un nceud text, d'un nceud comment, d'un nceud attribute ou d'un nceud 
name-space estl'URI de base de son nceud parent. 

Prenons par exemple I'instruction <xsi : inci ude href=" ..."/> d'une certaine feuille de style que I'on suppose 
ecrite d'un seul tenant (pas d'entite externe). L'URI de base de cette instruction est done I'URI de base de la 
feuille de style elle-meme, qui n'est autre que le repertoire qui la contient. Si done I'URI indique dans I'attribut 
href est un URI relatif, ilsera alors resolu par rapport ace repertoire. 

Deux documents sont considers comme n'en faisant qu'un s'ils sont identifies par le 
meme URI. L'URI utilise pour la comparaison estl'URI absolu pour lequel chaque URI 
relatif a ete resolu et ne contient aucun identificateur de fragment. Les nceuds racine de 
deux documents identifies par le meme URI sont consideres comme indiscernables. 
Ainsi, I 'expression suivante est touj ours vraie: 

generate-id (document (" true. xml"))=generate-id (document ( n t rue. xml ")) 

Avec la fonction documento, s'ouvre la possi bilite qu'un node-set puisse contenir des 
nceuds provenant de plusieurs documents differents. Dans un tel node-set, I 'ordre de lec- 
ture du document applicable a deux nceuds provenant du meme document est I 'ordre nor- 
mal de lecture du document defini par X Path. L'ordrede lecture du document applicable 
a deux nceuds provenant de deux documents differents est determine par I 'implementa- 
tion. La seule contrainte est que ('implementation doit etre coherente avec elle-meme : 
un meme ensemble de documents doit toujours produire le meme ordre. 

node-set key( string , object ) 

La fonction keyo joue le meme role pour les des que celui de la fonction ido pour les 
IDs. Le premier argument sped fie I enom delacle. La valeurdecet argument doit etre un 
QName (nom qualifie). Lorsque le type du deuxieme argument de la fonction keyo est 
un node-set, alors le resultat est la reunion des resultats de I 'application de la fonction 
key( ) a la valeur de la chalne de caracteres de chacun des nceuds du node-set recu en 
deuxieme argument par la fonction. Si le type du deuxieme argument de la fonction 
key ( ) n'est pas le type node-set, alors I 'argument est converti en une chaine de caracteres 
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comme par appel a la fonction str-ingo ; elleretourneun node-set contenant des noeuds 
du meme document que celui auquel appartient le nceud contexte. Ces noeuds sont ceux 
qui ont une valeur pour cette cle nominee, et pour lesquels cette valeur est egale a cette 
chaine de caracteres. 

Etantdonne, parexemple, la declaration suivante : 

| <xsl:key name="idkey" match="di v" use="@id"/> 

I 'expression key("idkey",@ref) retourne le meme ensemble de noeuds que id(@ref), a 
condition que leseul attribut I D declare dans le document source X ML soit: 

<!ATTLIST div id ID #IMPLIED> 

et que I 'attribut ref du noeud courantnecontiennepasd'espaceblanc. 

Considerons un document decrivant une bibliotheque de fonctions et utilisant un element 

prototype pour definir les fonctions : 

<prototype name="key" return-type="node-set"Xbr> 
<arg type="string"/Xbr> 
<arg type="object"/Xbr> 
</prototype> 

ainsi qu'un element functi on pour faire reference aux noms des fonctions : 

<function>key</function> 

La feuille de style peut alors generer des hyperliens entre les references et les definitions 
comme suit: 
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La fonction keyo peutetreutilisee pour recuperer une cle a partir d'un document autre 
que le document contenant le noeud contexte. Supposons par exemple que nous ayons un 
document contenant des references bi bliographiques sous la forme <bi bref >xsi_T</bi bref >, 
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etqu'il y ait un document XM L separe bib.xmi contenant la base de donnees bibliogra- 
phiques, avec des entrees de la forme : 



Mors, pour la transformation des elements bibref la feuille de style peut contenir ce qui 
suit: 

<xsl:key name="bib" match="entry" use="@name"/> 

<xsl :template match="bibref"> 

<xsl variable name="name" select="."/> 

<xsl :for-each select=" document ( ' bib.xml ' )"> 

<xsl : apply- templates select="key( 'bib' ,$name)"/> 

</xsl:for-each> 
</xsl: template) 

string generate-id( node-set ) 

L a fonction generate-i d( ) retourne une chaine de caracteres qui identifie d'une maniere 
unique le nceud dans le node-set recu en argument, qui est le premier nceud dans I'ordre 
de lecture du document. L'identificateur unique doit etre compose de caracteres ASCII 
alphanumeriques et doit commencer par un caractere alphabetique. C'est done un nom 
XML syntaxiquement correct. Une implementation est libredegenerer un identificateur 
delafacon qui lui est la plus appropriee, a condition que pi usieurs generations successi- 
vespourun meme nceud donnenttoujourslememe identificateur, et que deux nceudsdis- 
tincts donnent toujours des identificateurs distincts. Une implementation n'est pas 
obligee degenerer les memes identificateurs chaquefoisqu'un document subi une trans- 
formation. Rien ne garanti qu'un identificateur genere sera necessairement distinct de 
tous les IDs uniques specifies dans le document source. Si le node-set recu en argument 
est vide, la fonction retourne la chaine de caracteres vide. Si I 'argument est omis, le 
nceud contexte est pris par defaut comme argument. 

Note 

La suite de cette section consacree a la fonction generate-id( ) ne fait plus partie de la traduction. 

Cette fonction a ete largement commentee, notamment dans le chapitre sur les Patterns 
de transformation. Une application inattendue est celle qui consisteacontourner certai- 
nes interdictions syntaxiquesdans les motifs associes a une regie de transformation. On 
sait qu'un motif est une expression XPath bridee (voir Syntaxe et contrainte pour un 
motif XSLT, page 98). Un jour, sur la liste de discussion XSLT de mulberrytech (xsi- 
list@lists.mulberrytech.com dont I 'archive est consumable sur www.biglist.com/lists/xsl-listy 
archives), quelqu'un a demande comment ecrire un motif qui Concorde avec le premier 
nceud texte descendant d'un element quelconque, disons <item> (faire eventuellement 
une recherche sur Google avec « [xsl] Selecting first descendant text node»). II recut 
trois reponses, une erronee et deux correctes. La reponse erronee etait celle-ci : match= 
"(item//texto)[i]". Ce motif est incorrect parcequ'i I est interditderegrouper certains 
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elements d'un motif avec des parentheses. Par contre, c'est une expression XPath cor- 
recte, etqui exprimebien I'idee souhaitee. 

L'une des deux reponses correctes, envoyeepar M ichael Kay, etait celle-ci : 

textOE generate-id() = generate-id( ( ancestor: : item//text( ) )[1] ) ] 

L'idee est ici de contourner I 'interdiction en placant a I'interieur du predicat les choses 
interdites, car un motif n'impose aucune contrainte particuliere aux eventuels predicats 
utilises. Done, ici, on va dire que le motif doit concorder avec n'importe quel texte, 
pourvu que... 

Le « pourvu que ... » reprend tout simplement I'expression XPath de la fausse bonne 
reponse (item//text())Ei], en I'amenageantun peu. En effet, on peutdire, commeLa 
Pal ice, que tout texte convient, pourvu qu'il soitle premier descendant d'un <item>, puis- 
que e'etait precisement cela la question. Comme on a un test d'identite a effectuer (ce 
texte est-il lememequetel autre?), lafonction generate-ido est done mise a contribu- 
tion. Etantdonneun noeud texte T, la question devient: cenoeud texte est-il lememeque 
celui represents par I'expression ( ancestor: :item//texto )[i] eval uee avec T comme 
noeud contexte ? Cette expression represente I e premier noeud texte descendant d'un ele- 
ment item qui est un ancetredeT. Done finalement, le motif se lit: tout noeud texte T, 
pourvu qu'il soit le meme que le premier noeud texte descendant d'un element item qui 
est un ancetredeT. 

Inutile de dire qu'une telle recherche de concordance peut etre assez couteuse en temps 
decalcul ; c'est pourquoi la conclusion de Michael Kay fut qu'il etait probablement pre- 
ferable de repenser le probleme pour eviter d'avoir une regie avec un motif aussi etrange. 

string unparsed-entity-uri( string ) 

Lafonction unparsed-entity-uno retourne I'URI del'entite(nonanalyseeparun par- 
seur XML) dont le nom est sped fie par la string fournie en argument, et declaree dans la 
DTD du document dont le noeud contexte est issu. Si une telle entite n'existe pas, alors 
la fonction retourne une chaine de caracteres vide. 

node-set currentO 

La fonction current( ) retourne un node-set ayant pour seul element le noeud courant. 
Pour une expression dont revaluation ne depend pas d'une autre expression, le noeud 
courant se confond toujours avec le noeud contexte. A insi, 

<xsl :value-of select="current( )"/> 

a la meme signification que: 

<xsl:value-of select="."/> 

Cependant dans des crochets (i.e. dans un predicat), le noeud courant est habituellement 
different du noeud contexte. Par exemple, 

<xsl : apply- templates select="//glossary/item[@name=current( )/@ref ]"/> 
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vatraiter tousles elements item qui ontun element glossary parent et qui ontun attribut 
namedontlavaleurestegalealavaleurdel'attribut ref du noeud courant. Ceci est diffe- 
rent de 

J <xsl :apply-templates select="//glossary/item[@name=./@ref ]"/> 

qui signifie la meme chose que : 

<xsl :apply-templates select="//glossary/item[@name=@ref]"/> 

permettant de traiter tous les elements 1 tem ayant un element gi ossa ry parent et ayant un 
attribut name et un attribut ref qui setrouvent avoir la memevaleur. 

L'utilisation delafonction currento dans un motif est une erreur. 

Formatage de nombres 

string format-number( number, string , string ) 

La fonction format-number( ) convertit un nombre en une chaine de caracteres. Le pre- 
mier argument est le nombre a convertir ; le deuxieme est un motif sped fiant I e format de 
conversion ; letroisieme argument represented format decimal (en son absence, il y aun 
format decimal par defaut). La chaine de caracteres constituant le motif de conversion 
doit respecter la syntaxe speci flee par la classe Decimal Format duJDK 1.1 (Kitdedeve- 
loppement Java de Sun Microsystems). Le motif de specification de format est une 
chaine I ocali see (i.e. susceptible desubir des variations propres a la langueetaux coutu- 
mes culturelles du pays de I'utilisateur) : le format decimal determine quels sont les 
caracteres ayant une signification particuliere dans le motif (a I'exception du guillemet 
qui n'est pas localise). Le motif de format ne doit pas contenir le symbole de la devise 
monetaire(#x00A4) ; le support decettecaracteristique a eteajouteapres la livraison ini- 
tiale du JDK 1.1. Le nom du format decimal doit etre un QName (nom qualifie). La 
feuille de style doit contenir une declaration du format decimal avec ce nom qualifie, 
sinon c'est une erreur. 

Note 

Les implementations ne doivent pas forcement utiliser 1'implementation du J DK 1.1, ni etre forcement realisees 
en Java. 
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Fonctions diverses 

object system-property( string ) 

L'argument de cette fonction doit etre une chaine de caracteres representant un QName 
(nom qualifie). Le QName est evalue en utilisant la declaration dedomaine nominal en 
vigueur pour I 'expression en cours. La fonction system-property o retourne un objet 
representant la valeur de la propriete systeme identified par le nom. Si une telle propriete 
systeme n'existe pas alors la chaine de caracteres vide est retournee. 

Les implementations doivent fournir les proprietes systeme suivantes qui sont toutes 
dans ledomaine nominal XSLT : 

• xsi version. C'est un nombre qui indiquela version deXSLT supported par lepro- 
cesseur ; Cette valeur est 1.0 pour les processeurs XSLT implementant la version de 
XSLT specifiee dans ce document. 

• xsi vendor. C'est une chaine de caracteres identifiant le fabriquant du processeur 
XSLT. 

• xsi :vendor-uri. C'est une chaine de caracteres qui contient une URL identifiant le 
fabricant du processeur XSLT ; typiquement, cette URL est la page d'accueil (home 
page) du site Web du fabriquant. 

booleen element-available( chaine de caracteres ) 

La chaine de caracteres passee en argument doit etre un nom qualifie (QName), qui est 
evalue d'apres les domaines nominaux en vigueur pour I'expression en cours. La fonc- 
tion eiement-avaiiabieo retourne la valeur vrai si etseulementsi lenom obtenu estle 
nom d'une instruction. Si lenom obtenu est dans ledomaine nominal deXSLT, alors il 
reference un element defini par XSLT. Sinon, il reference une extension. Si ledomaine 
nominal du nom estnul, la fonction element-avail ableO retourne la valeur faux. 

booleen function-available( chaine de caracteres ) 

La chaine de caracteres passee en argument doit etre un nom qualifie (QName), qui est 
evalue d'apres les domaines nominaux en vigueur pour I'expression en cours. La fonc- 
tion function-avail ableO retourne la valeur vrai si etseulementsi lenom obtenu estle 
nom d'une fonction dela bibliotheque. 

Si lenom obtenu est dans ledomaine nominal nul, alors il reference une fonction prede- 
fine par XPath/XSLT ; sinon, il reference une extension. 



F 



Glossaire 



Axe de localisation. En anglais Axis. Point de depart d'une etape de localisation. Etant 
donne un nceud contexte, donne les nceuds qui partagent entre eux une meme relation de 
parente vis-a-vis de ce nceud contexte (parent, enfant, frere, descendant, etc.). Un axe 
de localisation peut etre direct ou retrograde, suivant qu'il contient de nceuds qui sont 
situes apres ou avant le nceud contexte, lorsqu'on suit I'ordre de lecture du document. 

Axis. VoirAxe de localisation. 

Attribute ValueTemplate. Voir Descripteur de valeur diff<?r<?ed'attribut. 

BaseURI.VoirURI debase. 

Chemin de localisation. En anglais Location Path. Variante restrictive d'expression 
XPath capable de selectionner un node-set constitue de nceuds preleves dans un docu- 
ment source X M L et possedant tous une meme propriete expri mee par le chemi n de loca- 
lisation sous la forme d'une suite d'etapes de localisation. 

Context Node. Voir N«ud contexte. 

C urrent Node. Voir Nceud courant. 

Descripteur de valeur differeed'attribut. En anglais Attribute Value Template (AVT). 
C'est une forme syntaxiquespecialedecrivant une valeur d'attri but sous la forme d'une 
expression X Path entre accolades. 

Vis a vis de cette propriete, on peut classer les attributs en trois categories : ceux dont les 
valeurs sont toujours evaluees statiquement (ou litteralement), ceux dont les valeurs sont 
toujours interpreters dynamiquement, et ceux dont les valeurs acceptees sont en principe 
litterales, mais qui admettent exceptionnellement que la valeur fournie soit interpretee 



dynamiquement, a condition qu'elle prenne la forme d'un descripteur de valeur differee 
d'attribut. 

Determinant. En anglais Node Test. Premier filtre qui determine les nceuds interessants 
d'un axe de localisation, dans I 'expression d' une etapede localisation. 

Domaine nominal. En anglais Namespace. Un vocabul aire de noms XML a qui I'on 
donneun nom qui prend generalementlaformed'uneURL. On trouve parfois la traduc- 
tion espacedenoms. 

Distribution selective. En anglais Push processing. Traitement partiel d'un element 
suivi d'une remise desesconstituants dans la pile des elements atraiter. En XSLT, I'ins- 
truction <xsi :appiy-tempi ates> est typique de cette categorie de traitement. 

Element source litteral. En anglais Litteral Result Element. ElementXM L en dehors du 
domaine nominal deXSLT (et des extensions eventuellementutilisees) ; lecontenu d'un 
tel element XM L est un modele de transformation, litteral ou non. Un element source 
litteral peutconstituer en lui-memeun modele de transformation, litteral ou non. 

Etapede localisation. En anglais Step Location. Variante restrictive d'expressionX Path 
qui fournit uneetape dans la construction d'un chemin de localisation. Uneetape filtre 
les nceuds selectionnes par I'etape precedente. 

E space blanc. En anglais Whitespace. Caractere d'espacement (espace, tabulation, saut 
deligne, retour chariot). 

Extraction individuelle. En anglais Pull processing. Traitement qui consiste a extraire 
une information connaissant I'endroit ou elle se trouve. En XSLT, ^instruction 
<xsi :vaiue-of> est typique de cette categorie. 

Grouping. Voir Regroupement. 

Indicedeproximite. En anglais Proximity position. Numero d'ordred'un nceud au sein 
d'un axe de localisation relatif a un nceud contexte. Pour un axe direct, les indices de 
proximiteaugmententquand on s'eloignedu nceud contexte en suivant I 'ordrede lecture 
du document, alors que pour un axe retrograde, les indices de proximite augmentent 
quand on s'eloignedu noeud contexte dans I'ordre inverse de lecture du document. 

Lexeme. En anglais token. PI us petite suite decaracteresreconnuecommeformant quel - 
que chose digne d'i nteret par un analyseur. D ans I e contexte d'X SLT, la notion de lexeme 
intervientpour lafonction d'extensionXalanou Saxon tokenizeo, qui decode la chaine 
de caracteres fournie, comme une suite de lexemes separes (par defaut) par des espaces 
blancs. 

Litteral Result Element. Voir Element Source Litteral. 

Location Path. Voir Chemin de localisation . 



Modelede transformation. En anglais template. C'est le fragment de document XM L 
associea une instruction, qui decritlecontenu decette instruction. 

Modelede transformation litteral. C'est un modele de transformation qui ne contient 
que du texte, ou des elements XM L en dehors du domaine nominal de XSLT (et des 
extensions eventuellement utilisees) ; un tel element XM L est un element source litteral 
(Litteral Result Element). 

Modele nomme. En anglais named template.A la memeformequ'une regie de transfor- 
mation, mais possede un attri but name (a la place de I'attribut match) qui permet de 
I'appeler explicitement. 

Motif. En anglais pattern. Variante restrictive d'expression XPath utilisee principale- 
ment pour specifier (par le truchement de son attri but match) sur quels nceuds telle regie 
de transformation doits'appliquer. 

Named template. Voir M odele nomme. 

Namespace. Voir Domaine nominal. 

Node-set. Type predefini deX Path, qui represents un ensemble de nceuds au sens mathe- 
matique du terme (pas d'ordre, pas de doublon). Pas d'equivalent francais dans ce livre, 
car N ode-set est un nom de type, considers comme un nom propre. 

Node Test. Voir Determinant. 

Noeud contexte. En anglais Context Node. Nceud par rapport auquel on evalue une 
expression XPath. 

Noeud courant. En anglais Current Node. Noeud en coursdetraitement. 

Pattern. Voir Motif. Dans ce livre, le mot pattern est aussi utilise au sens de pattern 
design (mise en evidence d'un type de probleme et d'une facon de raisonner ou d'organi- 
ser son programme pour le resoudre de facon generique). 

Pattern Matching. Voir Recherche de concordance de motif. 

Predicat. En anglais Predicat. Expression XPath quelconque, qui, lorsqu'elle est appli- 

quee a un node-set et convertie en booleen, fournit un critere d'acceptation ou de rejet 
pour constituer un nouveau node-set moins peuple. 

Predicat. Voir Pre'dicat. 

Prefix. Voir Pre/zxe. 

Prefixe. En anglais Prefix. Abreviation d'un domaine nominal placee devant un nom 
d'elementou d'attributXM L. 



Proximity position. Voir I ndice de proximite. 



Pull processing. Voir Extraction individuelle. 

Push processing. Voir Distribution selective. 

Recherche de concordance de motif. En anglais Pattern Matching. Processus de 
recherche d'une regie dontle motif (voircemot) concordeavec lenceud en cours detrai- 
tement. 

Regie de transformation. En anglais template rule. Definit une transformation elemen- 
tal re. Une regie de transformation est selection nee si son attri but match contientun motif 
qui Concorde avec le nceud en cours de traitement. 

Regie nominee. Pas de terme anglais consacre. Construction hybride, a la fois modele 
nomme (possede un attri but name) et regie de transformation (possede un attri but match). 

Regroupement. En anglais Grouping. Traitement au cours duquel des elements epar- 
pilles ca et la dans le document source XML sont regroupes dans le document resultat en 
fonction d'une propriete commune. Ce genre de traitement est celebre pour etre coriace a 
programmer en XSLT 1.0 ; mais pour calmer la foule en colere, le groupe de travail 
XSLT 2.0duW3C a propose une nouvelle instruction qui devraitsimplifierconsiderable- 
mentlaprogrammation. 

Step Location. Voir E tape de localisation. 

Template. Voir M odele de transformation. 

Template rule. Voir Regie de transformation. 

Temporary Source Tree. A breviation TST. Arbre XML qui resulte de I'instanciation 
d'un modele de transformation propre a une declaration de variable. Cet arbre peut 
constituer une source XML secondaire, car on peut I'explorer avec une expression 
XPath, soit directement (XSLT 1.1 ou 2.0), soit apres conversion en node-set a I'aide 
d'une fonction de conversion fournie en tant qu'extension par le processeur utilise 
(XSLT 1.0). 

Ce terme n'est pas officiel. II est derive de la proposition de M ichael Kay, Temporary 
Tree, et reprise dans le premier Working DraftXSLT 2.0 du W3C. 

Token. Voir lexeme. 

URI (Uniform Resource Identifier). Terme generique, qui designe a la fois les URL 
(Uniform Resource Locator) et les URN (Uniform Resource Name). Dans ce livre, on 
peut dire que URI etURL sont equivalents. 

URI debase. En anglais Base URI. URI par rapport auquel on determine un URI relatif. 

Whitespace. Voir E space blanc. 
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• http://www.mulberrytech.com/: un sitetres actif pour XSL. Ony trouvera (entre autres) 
des aide-memoire XM L etXSLT/XPath (en PDF) tres bien faits. 

• http://xmlfr.org/ : un site en francais consacre a X M L et done a XSL (entre autres). 

• http://xml.coverpages.org/sgml-xml.html: le site de Robin Cover, une compilation de 
tout ce qui concerne XML et SG M L . 

Des sites de telechargement de produits X SL : 

• http://saxon.sourceforge.net/ : le site de telechargement de Saxon, le processeur XSLT 
de Michael Kay. 

• http://xml.apache.org/xalan-j/: le site de telechargement de Xalan, I e processeur XSLT 
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ancien mais toujours le plus rapide. 
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